Delano Lourenco

GDAI MCP

Let AI build in your Godot editor.

GDAI MCP is an MCP server for Godot. Claude, Cursor, VS Code and other MCP clients can create scenes and nodes, write and fix GDScript, read errors from the debugger, and take screenshots of the editor and the running game.

Get GDAI MCPDocsSupported toolsGitHub
Engine
Godot 4.2+
Clients
Claude Code, Claude Desktop, Cursor, VS Code Copilot, Windsurf, Zed, any MCP client
Model
Paid plugin, usable in commercial games
GitHub
102 stars

Make a top-down car game where the player collects coins before the timer runs out.

get_project_infoproject.godot
create_sceneres://race.tscn
add_nodeCar · CharacterBody2D
add_nodeShape · CollisionShape2D
add_scenecoin.tscn × 5 → Coins
add_nodeTimer · Label
create_scriptres://car.gd
attach_scriptcar.gd → Car
play_scenerace.tscn
get_godot_errorsoutput, debugger

car.gd:12 Identifier “velocty” not declared

edit_filecar.gd velocty → velocity
play_scenerace.tscn
get_running_scene_screenshotgame window

Done. Arrow keys drive the car and each coin adds to the score. I also fixed a typo on line 12 of car.gd.

Scene

  • RaceNode2D
  • Carcar.gdCharacterBody2D
  • ShapeCollisionShape2D
  • CoinsNode2D
  • Coin × 5coin.tscn
  • TimerLabel

Empty project

Game Not running

Coins 0/52:00Parse errorcar.gd, line 12
0:00
An illustrative session. Every tool shown is a real GDAI MCP tool.

See it build

Recordings of GDAI MCP working in a real Godot project.

Set up in three steps

Full instructions for each client are in the installation guide.

  1. Install uv, then copy addons/gdai-mcp-plugin-godot into your project and enable the plugin.

  2. Copy the JSON config shown in the GDAI MCP tab into your MCP client.

  3. Start chatting. Ask it to describe your project to check the connection.

What’s included

Scenes and nodes

create_scene
New scene with a root node of any type.
add_node
Add, move, duplicate and delete nodes in the open scene.
update_property
Set node properties and attach resources such as shapes and textures.
play_scene
Run the current scene or the main scene, then stop it.

Scripts

create_script
Write a GDScript file and attach it to a node.
edit_file
Targeted find-and-replace edits instead of rewriting files.
get_open_scripts
Read what is open in the script editor.

Seeing what happened

get_godot_errors
Script errors, runtime errors, stack traces and output logs.
get_running_scene_screenshot
A screenshot of the running game, so the AI can check its work.
get_editor_screenshot
A screenshot of the whole editor window.

Your project

get_project_info
Reads project.godot and project settings.
search_files
Fuzzy search across res://, so a prompt can name an asset.
get_scene_tree
The full node tree with visibility and script info.