What it does
Agent-driven Godot playtesting: editor control, input injection, game-time stepping, live state.
- Connects Se ejecuta en tu computadora
- Account or key No key needed
- Category Juegos, deportes, comida y aprendizaje
Por qué está en este puesto
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 36/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 48/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 88 (Solo se usa en la pestaña En auge)
Instalación
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Godot MCP. Sigue https://mcp.popnx.com/i/satelliteoflove-godot-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 17 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Que la IA lo instale
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Godot MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "godot": { "command": "npx", "args": [ "-y", "@satelliteoflove/godot-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Godot MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "godot": { "command": "npx", "args": [ "-y", "@satelliteoflove/godot-mcp" ] } } }Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Godot MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Godot MCP o muestra una herramienta de Godot MCP en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GODOT_HOSTReemplaza el host usado para conectarse al puente del editor de Godot (por ejemplo, para WSL2 o configuraciones remotas). Se detecta automáticamente si no se establece.Ver original en inglés
Override the host used to reach the Godot editor bridge (e.g. for WSL2 or remote setups). Auto-detected when unset.GODOT_MCP_READ_ONLYEstablecer en 1 (o true) para registrar solo herramientas de observación de solo lectura: sin edición de escenas/nodos/animaciones, sin control del juego y sin inyección de entradas. Equivale al indicador --read-only.Ver original en inglés
Set to 1 (or true) to register only read-only observation tools: no scene/node/animation edits, no game control, no input injection. Same as the --read-only flag.
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Godot MCP
Godot MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Godot MCP
- Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Instala Node.js en tu computadora primero (una sola vez)
- Instala Node.js en tu computadora primero (una sola vez)
- Instala Node.js en tu computadora primero (una sola vez)
B · Otros en Juegos, deportes, comida y aprendizaje que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Godot MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user godot -- npx -y @satelliteoflove/godot-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Godot MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user godot -- npx -y @satelliteoflove/godot-mcpEscribe /mcp en Claude Code
Deberías ver Godot MCP en la lista como conectado
Pruébalo
Usa Godot MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Godot MCP o muestra una herramienta de Godot MCP en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GODOT_HOSTReemplaza el host usado para conectarse al puente del editor de Godot (por ejemplo, para WSL2 o configuraciones remotas). Se detecta automáticamente si no se establece.Ver original en inglés
Override the host used to reach the Godot editor bridge (e.g. for WSL2 or remote setups). Auto-detected when unset.GODOT_MCP_READ_ONLYEstablecer en 1 (o true) para registrar solo herramientas de observación de solo lectura: sin edición de escenas/nodos/animaciones, sin control del juego y sin inyección de entradas. Equivale al indicador --read-only.Ver original en inglés
Set to 1 (or true) to register only read-only observation tools: no scene/node/animation edits, no game control, no input injection. Same as the --read-only flag.
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Godot MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "godot": { "command": "npx", "args": [ "-y", "@satelliteoflove/godot-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Godot MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Godot MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Godot MCP o muestra una herramienta de Godot MCP en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GODOT_HOSTReemplaza el host usado para conectarse al puente del editor de Godot (por ejemplo, para WSL2 o configuraciones remotas). Se detecta automáticamente si no se establece.Ver original en inglés
Override the host used to reach the Godot editor bridge (e.g. for WSL2 or remote setups). Auto-detected when unset.GODOT_MCP_READ_ONLYEstablecer en 1 (o true) para registrar solo herramientas de observación de solo lectura: sin edición de escenas/nodos/animaciones, sin control del juego y sin inyección de entradas. Equivale al indicador --read-only.Ver original en inglés
Set to 1 (or true) to register only read-only observation tools: no scene/node/animation edits, no game control, no input injection. Same as the --read-only flag.
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Godot MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "godot": { "type": "stdio", "command": "npx", "args": [ "-y", "@satelliteoflove/godot-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Godot MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión:
node -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Godot MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Godot MCP o muestra una herramienta de Godot MCP en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GODOT_HOSTReemplaza el host usado para conectarse al puente del editor de Godot (por ejemplo, para WSL2 o configuraciones remotas). Se detecta automáticamente si no se establece.Ver original en inglés
Override the host used to reach the Godot editor bridge (e.g. for WSL2 or remote setups). Auto-detected when unset.GODOT_MCP_READ_ONLYEstablecer en 1 (o true) para registrar solo herramientas de observación de solo lectura: sin edición de escenas/nodos/animaciones, sin control del juego y sin inyección de entradas. Equivale al indicador --read-only.Ver original en inglés
Set to 1 (or true) to register only read-only observation tools: no scene/node/animation edits, no game control, no input injection. Same as the --read-only flag.
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user godot -- npx -y @satelliteoflove/godot-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"-y",
"@satelliteoflove/godot-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"-y",
"@satelliteoflove/godot-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"godot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@satelliteoflove/godot-mcp"
]
}
}
}Valores que debes completar
GODOT_HOSTenvReemplaza el host usado para conectarse al puente del editor de Godot (por ejemplo, para WSL2 o configuraciones remotas). Se detecta automáticamente si no se establece.Ver original en inglés
Override the host used to reach the Godot editor bridge (e.g. for WSL2 or remote setups). Auto-detected when unset.GODOT_MCP_READ_ONLYenvEstablecer en 1 (o true) para registrar solo herramientas de observación de solo lectura: sin edición de escenas/nodos/animaciones, sin control del juego y sin inyección de entradas. Equivale al indicador --read-only.Ver original en inglés
Set to 1 (or true) to register only read-only observation tools: no scene/node/animation edits, no game control, no input injection. Same as the --read-only flag.
Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
- Descargas por semanai
- 1785/sem
- Conexión
- Se ejecuta en tu computadora
- Última versióni
- 4.3.0
- Publicado en el registroi
- 17 nov 2026
- Último cambio de códigoi
- 17 nov 2026
- Creador
- satelliteoflove
- Paquetes
npm: @satelliteoflove/godot-mcp- Sitio web
- github.com
- Estado en el registro
- Activo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub satelliteoflove, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: anteayer
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Aún no revisado
Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/satelliteoflove-godot-mcp)Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Juegos, deportes, comida y aprendizajei
- Más estrellas que el 99% de los otros 1619 servidores de esta categoría
- Publicado en el registro más recientemente que el 91% de los otros 1619 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 99% de los otros 1619 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Godot MCP?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez anteayer, y la última versión (4.3.0) llegó al registro anteayer.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Alternativas parecidas
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| Este Godot MCP | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
godot-mcp
Give your AI assistant eyes and hands in the Godot editor — and a running game it can actually playtest.
Why this one?
There are a few Godot MCP servers out there, and most can open a scene and poke at nodes. This one is built around a harder problem: letting an agent verify its own work. Run the game, drive it like a player, observe what actually happened, and prove the change did what it claimed — without you ferrying screenshots and error logs back and forth.
The pieces that make that possible, and that you won't find elsewhere:
- Deterministic playtesting. Freeze the game clock, step exact slices of game time (or step *until a condition holds*), with inputs riding inside the window. Observation never races the game.
- Cheap observation. Live entity state — positions, velocities, animation state, your own custom data — as structured JSON. Most "what's happening on screen?" questions get answered without spending vision tokens on a screenshot.
- Real input. Named actions with analog strength, joypad buttons and stick vectors, raw keys with modifier combos, relative mouse-look, text typing. Sequences run with precise timing and can prove they changed game state.
- Scenario setup. Run GDScript inside the running game: grant the weapon, skip to wave 3, spawn a test bot — no debug hooks baked into your game code.
Here's what that looks like when an agent tests a boss fight:
godot_editor_edit run frozen=true # boot with game time frozen at frame 0
godot_exec GameState.wave = 3 # set up the scenario worth testing godot_game_time step_until "tree.get_nodes_in_group('boss').size() >= 1" godot_runtime_state digest # exact positions and state — no pixels, no guessing godot_game_time step 500ms + dodge input # play the moment that matters godot_editor_read screenshot_game # and a screenshot when it's actually worth the tokens
Less copy-paste, more creating.
Quick Start
1. Configure your AI assistant
Add godot-mcp to your MCP client. See the Installation Guide for config examples (Claude Desktop, Claude Code, VSCode/Copilot, and more). The short version:
{
"mcpServers": { "godot-mcp": { "command": "npx", "args": ["-y", "@satelliteoflove/godot-mcp"] } } }
2. Install the Godot addon
npx @satelliteoflove/godot-mcp --install-addon /path/to/your/godot/project
Enable it in Godot: Project > Project Settings > Plugins > Godot MCP
3. Start building
Open your Godot project, restart your AI assistant, and start building. If anything refuses to connect, the Troubleshooting Guide has you covered.
What's in the box
21 tools, 86 actions. Full API docs in the Tools Reference.
| Tool | What it does |
|---|---|
godot_scene | Open and save scenes (create new scenes by writing the .tscn directly, then open) |
godot_node_read / godot_node_edit | Inspect effective properties, the full scene tree (including instanced sub-scenes), and find nodes; update properties and reparent |
godot_editor_read / godot_editor_edit | Editor state, selection, screenshots, editor error log; run/stop/restart and 2D viewport control |
godot_project | Project info, settings, addon version skew, and stale-settings detection |
godot_animation_read / godot_animation_edit | Query animations down to keyframes; author tracks and keyframes with instant editor preview |
godot_tilemap_read / godot_tilemap_edit | Read and edit TileMapLayer cells (base64-encoded in .tscn — the bridge is the only way) |
godot_gridmap_read / godot_gridmap_edit | Read and edit GridMap cells, same story |
godot_resource | Inspect resources with type-aware output: SpriteFrames, TileSet, Materials, Textures |
godot_scene3d | Engine-computed 3D transforms, bounding boxes, and visibility for spatial reasoning |
godot_docs | Fetch Godot documentation as clean markdown, version-matched to your editor |
godot_input | Inject input into the running game: actions, joypad, raw keys, mouse-look, text |
godot_profiler | Metric snapshots and per-frame time series with spike detection |
godot_runtime_state | Live game state as JSON: one-shot digests, watch windows, signal timelines |
godot_game_time | Freeze, step, and step-until on the game clock — deterministic observation |
godot_exec | Run GDScript inside the running game for test scenario setup |
godot_validate_meshes | Detect silently corrupt procedural mesh data that masquerades as lighting bugs |
A note on shape: tools split along the read/write boundary, so every godot_*_read tool (and the other read-only tools) can be safely auto-allowed in your client's permission settings while writes stay gated. Related operations still live as actions inside one tool, so your agent's context isn't flooded with definitions it won't use. Anything an agent can do by editing project files directly — creating scenes and nodes, attaching scripts, connecting signals — is deliberately *not* duplicated as a tool; the bridge covers what files can't: editor state, verification, binary-encoded cell data, and the running game. A --read-only flag serves the look-but-don't-touch use case.
Things to ask for
A feel for what an agent can do with this, in plain prompts:
- *"Run the game and screenshot the title screen. Does the layout survive 1280x720?"*
- *"The player can clip through the east wall. Reproduce it, then check the collision shapes and tell me why."*
- *"Step the game until the second wave spawns and give me every enemy's position and velocity."*
- *"Hold the left stick at half deflection for two seconds — does the walk animation blend correctly?"*
- *"Profile ten seconds of gameplay and find what's causing the frame spikes."*
- *"Add a hit-flash animation to the Player: modulate to red and back over 0.2 seconds."*
For richer runtime observation, add key nodes to the mcp_watch group or give them a _mcp_state() method — see the Runtime State Guide.
How it works
┌─────────────────┐ stdio ┌─────────────────┐ WebSocket ┌──────────────────┐ debugger ┌──────────────┐
│ MCP client │ ◄────────► │ godot-mcp │ ◄──────────► │ Bridge addon │ ◄─────────► │ Running game │ │ (Claude, etc.) │ │ server (Node) │ :6550 │ (Godot editor) │ wire │ (autoload) │ └─────────────────┘ └─────────────────┘ └──────────────────┘ └──────────────┘
The server talks to an editor addon over a local WebSocket; the addon reaches into the running game over Godot's own debugger protocol, so the game process needs no extra ports or setup. The addon binds to 127.0.0.1 by default. WSL2 is fully supported (auto-detection, host IP discovery, configurable bind modes) — see the Installation Guide.
Curious about connection lifecycles, the single-client policy, or how frozen-time stepping works under the hood? The Architecture Guide goes deep.
Works well with minimal-godot-mcp
minimal-godot-mcp by @ryanmazzolini covers exactly what this server doesn't: LSP diagnostics for fast static GDScript checking, and the running game's console output over DAP. This server covers everything that needs an editor bridge. No overlap, no conflict — run both, and your agent gets static analysis and the game console alongside full editor and runtime control.
One caveat: a Godot editor serves a single godot-mcp client at a time. Extra clients (a subagent inheriting your MCP config, say) wait their turn rather than hijacking your session — details in Troubleshooting.
Documentation
- Installation Guide — MCP client configs for Claude Desktop, Claude Code, VSCode/Copilot, and more
- Migrating to v4 — renamed tools, removed actions, allowlist updates
- Troubleshooting — connection checklist, CLI smoke test, common fixes
- Claude Code Setup Guide — CLAUDE.md template for Godot projects
- Runtime State Guide — expose game state to agents via
mcp_watchand_mcp_state() - Tools Reference — all 21 tools with full API docs
- Architecture Guide — how the server, addon, and game bridge fit together
- Contributing — dev setup, adding tools, release process
- Changelog — release history
Requirements
- Godot 4.5+ (the addon uses the Logger class introduced in 4.5)
- Node.js 20+
- Any MCP client that speaks stdio
Development
cd server
npm install && npm run build npm test # unit + schema-snapshot tests npm run test:protocol # wire-level smoke of the built server npm run generate-docs
There is also an agentic eval harness (npm run eval) that runs realistic tasks through headless Claude Code against a real project — see server/evals/README.md. It never starts Godot; you bring the open editor.
Contributions welcome — this project favors tools that solve real, time-wasting problems. Read CONTRIBUTING.md before building something big, or open an issue and we'll figure out the right shape together.