# GDevelop MCP, what exists today and what an agent can do

> GDevelop has its own AI agent inside the editor, and a few community MCP servers let Claude Code or Cursor work on a GDevelop project from outside. Here is what each does, where they stop, and when an engine with a full MCP server is the better fit.

- URL: https://www.summerengine.com/es/gdevelop-mcp
- Keyword: gdevelop mcp

**La respuesta corta:** There is no official GDevelop MCP server. We found no MCP code in the 4ian/GDevelop repository, and the open GitHub request for bring your own model support in the built-in agent is still under discussion. GDevelop's own AI agent lives in the Ask AI panel and edits scenes, objects, behaviours, variables and events using GDevelop credits. Community servers such as gdevelop-mcp by gb2b (MIT, 30 tools) edit the project JSON and render previews for Claude Code or Cursor. If you want an agent that runs the game, sends input and checks the result in a native engine, Summer Engine does that, but it does not import GDevelop projects. Moving means rebuilding.

GDevelop users searching for an MCP server usually want one thing. They already pay for Claude Code, Cursor or Codex and would rather use that agent than a second AI subscription inside the editor. That is a reasonable wish, and GDevelop's issue tracker shows it. A bring your own key request for the built-in agent has been open since October 2025.

Until something official exists, you have two routes inside GDevelop. Use GDevelop's own agent, which knows the editor and every official extension, or connect a community MCP server that reads and writes the project files from outside.

This page covers both with sources, explains what the GDevelop project format means for an outside agent, and describes the alternative of building in an engine whose MCP server also plays the game and looks at it.

## Qué hace

- **GDevelop's built-in agent:** Open Ask AI and choose Build for me. GDevelop documents that the agent creates scenes, objects, behaviours, variables and events and installs extensions. Requests use credits. Free accounts get a weekly allowance, and higher reasoning levels need a Gold or Pro subscription.
- **gdevelop-mcp by gb2b:** An MIT server with 30 tools and 5 prompts. It reads GDevelop's own source for its catalogue of about 1,830 actions, conditions and expressions, edits projects with dry runs, backups and undo, and captures a preview of a scene in headless Chromium.
- **gdevelop-mcp-server by 982945902:** A smaller MIT server built for Codex. It uses GDevelop's libGD.js to create and change project data, authors events without hand-written JSON, and serves a scene preview on a local address.
- **What an outside agent can see:** gdevelop-mcp renders a scene statically or captures a still from a real preview in headless Chromium, and gdevelop-mcp-server serves a live preview on a local address. Neither README lists a way to send input to the running game or read its state frame by frame, so testing a mechanic still means playing it yourself.
- **Summer as the engine-level alternative:** Summer Engine is a desktop engine compatible with Godot 4. Its MCP server edits scenes and GDScript, presses play, sends scripted input, reads frame-stamped probes and takes screenshots, so the agent verifies a mechanic by playing it.
- **Generators that work for GDevelop too:** Summer's cloud tools generate sprites, sprite sheets, backgrounds, sound effects and music without the Summer engine running. Download the files and add them to your GDevelop project as usual.

## Cómo funciona

1. **Switch the project to multiple files:** In the project properties, turn on saving the project as multiple files in a folder. Scenes, external layouts, external events and extensions each get their own JSON file, which makes an agent's changes small and reviewable. Put the folder in Git.
2. **Pick the agent route:** Use GDevelop's Ask AI if you want the editor's own agent and credits. Use a community MCP server if you want Claude Code, Cursor or Codex. Install it from its README and point it at your project JSON.
3. **Make every edit a dry run first:** gdevelop-mcp previews each change before it writes, keeps timestamped backups and can undo the last edit. Ask for a dry run, read the diff, then apply. Reopen the project in GDevelop to confirm it loads.
4. **Rebuild in Summer only if you want the full loop:** If you want the agent to play and verify the game, rebuild a vertical slice in Summer. Objects become nodes, behaviours become scripts or built-in nodes, and your event sheets are the specification.

## En Studio o desde el agente que ya usas

### En Summer Studio

Summer Studio on the web generates sprites, backgrounds, sound effects, voice lines and music for any engine. Download the files and import them into GDevelop.

[Open the image tab in Studio](https://www.summerengine.com/studio?tab=image)

### Desde Claude, Cursor o Codex vía MCP

You can register the Summer MCP next to a GDevelop MCP server in the same client. Summer's cloud tools such as summer_generate_image and summer_generate_audio work without the Summer desktop app, and summer_get_asset_download_url gives the agent a download link for each file.

Prompt de ejemplo para tu agente:

```text
Generate a coin pickup sound and a looping 30 second chiptune track with Summer, get me download links for both, and save them into the assets folder of my GDevelop project.
```

[Configurar el MCP de Summer](https://www.summerengine.com/es/mcp)

## AI routes for a GDevelop project on 2026-09-25

| Route | Maker | What it does | Cost |
| --- | --- | --- | --- |
| Ask AI, Build for me | GDevelop (official) | Creates scenes, objects, behaviours, variables and events inside the editor | GDevelop credits, weekly free allowance |
| gdevelop-mcp | gb2b | 30 tools, validated edits with undo, static render and headless Chromium preview | Free, MIT |
| gdevelop-mcp-server | 982945902 | Create and edit projects through libGD.js, author events, serve a local preview | Free, MIT |
| Official MCP server | None found | No MCP code in 4ian/GDevelop; bring your own model request still open | Not applicable |

Fuentes: [GDevelop AI documentation](https://wiki.gdevelop.io/gdevelop5/interface/ai/)

## What an agent can do in each setup

| Task | GDevelop with an MCP server | Summer MCP |
| --- | --- | --- |
| Read and edit game logic | Event sheets in JSON through the server | GDScript files and the scene tree |
| Create objects and scenes | Yes, through validated edits | Yes |
| See the result | Rendered still of a scene | Editor and game screenshots, snapshot diffs |
| Send input to the running game | Not listed | Yes |
| Read state at a given frame | Not listed | Yes, frame-stamped probes |
| Generate art and audio | GDevelop's asset store or any external generator | Built in |

## Cuánto cuesta

- Imagen, Nano Banana 2 Lite (1K): $0.06 (estimación)
- Efecto de sonido, 5 segundos: $0.01

Community GDevelop MCP servers are free to run. GDevelop's built-in agent uses GDevelop credits. Summer charges only for generation, from your usage balance.

Los precios se descuentan de tu saldo de uso de Summer. Generar assets requiere un plan de pago o una recarga: Pro cuesta $20 al mes e incluye $20 de uso, y las recargas empiezan en $5. El motor de escritorio se descarga gratis.

## Prompts que funcionan y lo que obtienes

What an outside agent does well with a GDevelop project, and one job that needs a different engine.

### Explain a project

- Prompt: Summarise every scene in my game.json, which objects each uses and which events change the score.
- Lo que obtienes: A structured read of the project. This is safe and fast with any server that parses the JSON.

### Add a mechanic from an example

- Prompt: Add a double jump to my Player object, as a dry run first.
- Lo que obtienes: A proposed edit with a diff you can review before anything is written.

### Preview a scene

- Prompt: Render the Level1 scene and show me what it looks like after the change.
- Lo que obtienes: A still of the scene from gdevelop-mcp's static render or its headless Chromium capture.

### Generate game audio

- Prompt: Make a jump sound, a hurt sound and a short victory jingle in a retro style.
- Lo que obtienes: Three audio files from Summer's generator, downloaded into your project's assets folder.

### Test the mechanic by playing

- Prompt: Run the game, jump twice at the first gap and tell me whether the player clears it.
- Lo que obtienes: Not listed by the GDevelop servers we read. In Summer the agent sends input, probes the player and shows a screenshot.

[Browse Summer presets](https://www.summerengine.com/es/presets)

## What the GDevelop project format means for an agent

A GDevelop project is JSON. By default it is one game.json file. In multiple files mode the scenes, external layouts, external events and extensions are split into their own files, and GDevelop recommends that mode for version control. GDevelop also warns that cloud sync tools such as Dropbox or OneDrive watching the folder can corrupt the project JSON.

Events are the hard part. In the official platformer example each condition and action is an object with a type such as `SystemInfo::HasTouchScreen` or `BuiltinExternalLayouts::CreateObjectsFromExternalLayout` and a list of positional string parameters, where text values carry their own escaped quotes. An agent editing that by hand has to get every identifier, parameter position and nesting level right, or the event loads but does not do what you meant. This is why the useful community servers validate edits against GDevelop's own sources or library instead of writing text. GDevelop also has JavaScript events, which an agent can write more reliably than raw event JSON.

## When to stay in GDevelop

Stay if you like building with events, if your team is not writing code, or if HTML5 publishing to many web destinations is the core of your release. GDevelop is built around that, while Summer web builds play on Summer Games. Stay too if the built-in agent's credits suit you. It knows every official extension and edits the project from inside the editor, which avoids the file format problem altogether.

## When to move a GDevelop game to an engine with a full MCP server

Move when you want the agent to test, not only edit. Summer's agent runs the game, sends input, reads the player's position at the frame it lands, takes a screenshot and fixes what it finds. You write in GDScript, with C# available in the desktop editor, and you own the project with no royalties.

Summer does not import GDevelop projects. The rebuild reuses your art, audio and level design, and your event sheets become the specification for scripts. Summer builds desktop games for Windows and macOS for Steam and itch.io.

## Preguntas frecuentes

### Is there an official GDevelop MCP server?

Not that we could find. The 4ian/GDevelop repository has no MCP code, and a request to let the built-in agent use your own model or key has been open since October 2025.

### Can Claude Code or Cursor edit a GDevelop project?

Yes, through a community MCP server such as gdevelop-mcp by gb2b or gdevelop-mcp-server by 982945902. They parse the project JSON and write validated changes. Commit to Git before each session.

### Is GDevelop's AI agent free?

GDevelop documents a weekly free allowance for its AI. Requests use credits, higher reasoning levels need a Gold or Pro subscription, and you can buy extra credits.

### Can an agent edit GDevelop events safely?

Only through a tool that understands the event format. Raw JSON edits easily produce events that load but never fire. Use a server with dry runs and undo, or GDevelop's own agent, and reopen the project to check.

### Can Summer import my GDevelop project?

No. Moving from GDevelop to Summer means rebuilding, with your assets reused and your events as the specification. Summer exports web builds that play on Summer Games, but GDevelop documents more web destinations.

### How does GDevelop compare with Godot for AI work?

GDevelop is event based with a built-in agent. Godot 4 projects are code and scene files that terminal agents handle well, and Summer adds an MCP server that runs and checks the game. Our Godot vs GDevelop guide goes deeper.

## Herramientas y guías relacionadas

- [Godot MCP setup](https://www.summerengine.com/es/godot-mcp)
- [Summer MCP and CLI](https://www.summerengine.com/es/mcp)
- [Claude Code game development](https://www.summerengine.com/es/claude-code-game-development)
- [Summer vs GDevelop](https://www.summerengine.com/es/summer-vs-gdevelop)
- [Godot vs GDevelop](https://www.summerengine.com/es/blog/godot-vs-gdevelop)
- [GDevelop alternative](https://www.summerengine.com/es/gdevelop-alternative)
- [GameMaker MCP](https://www.summerengine.com/es/gamemaker-mcp)
- [Construct 3 MCP](https://www.summerengine.com/es/construct-3-mcp)

## Fuentes

- [Build and learn with GDevelop AI (GDevelop documentation)](https://wiki.gdevelop.io/gdevelop5/interface/ai/)
- [GDevelop's AI Agent (GDevelop blog)](https://gdevelop.io/blog/make-games-with-ai-agent-gdevelop-automated-prompt)
- [How to use GDevelop as a team (GDevelop documentation)](https://wiki.gdevelop.io/gdevelop5/tutorials/how-to-use-gdevelop-as-a-team/)
- [BYOK support for GDevelop AI Agent, issue 7932](https://github.com/4ian/GDevelop/issues/7932)
- [gb2b/gdevelop-mcp on GitHub](https://github.com/gb2b/gdevelop-mcp)
- [982945902/gdevelop-mcp-server on GitHub](https://github.com/982945902/gdevelop-mcp-server)
- [gdexporter, export GDevelop games from the command line](https://github.com/arthuro555/gdexporter)
- [GDevelop official platformer example project](https://github.com/GDevelopApp/GDevelop-examples/tree/main/examples/platformer)

[Set up the Summer MCP](https://www.summerengine.com/es/godot-mcp)

---

## Machine-readable resources

- Site index for agents: https://www.summerengine.com/llms.txt
- Full inlined content: https://www.summerengine.com/llms-full.txt
- Porting catalog: https://www.summerengine.com/llms-porting.txt
- Structured catalog: https://www.summerengine.com/agent-catalog.json
- Sitemap: https://www.summerengine.com/sitemap.xml
- Developer resources: https://www.summerengine.com/docs