Godot MCP Pro is an MCP server with 163 tools that connects AI assistants like Claude and Cursor directly to the Godot 4 editor via WebSocket. It lets AI create scenes, write GDScript, simulate player input, inspect running games, build 3D environments, set up physics, manage particles and audio — all from a single conversation. $5 one-time purchase, works on Windows, macOS, and Linux.
$5 one-time purchase · Lifetime updatesOne prompt → AI builds a complete Reversi game, launches it, and play-tests with mouse clicks.
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
Real-time bidirectional communication. No file polling. No CLI subprocess spawning. Just instant feedback.
Practical Godot 4 guides powered by AI. No outdated Godot 3 info — everything here is tested on Godot 4.4+.
Set up MCP Pro in 5 minutes and let Claude or Cursor directly control your Godot editor. Install the plugin, build the server, configure your AI client — and you're ready.
get_project_info get_scene_treeAsk AI to create a complete 2D game — scenes, scripts, signals, UI. This guide walks through building a Reversi board game in a single AI conversation, from empty project to playable game.
create_scene add_node create_script connect_signal play_sceneBuild a third-person character controller with Mixamo animations, AnimationTree state machine, SpringArm3D camera, and terrain — all created by AI. Covers CharacterBody3D, physics layers, and animation blending in Godot 4.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dGodot 4 overhauled signals from Godot 3. No more connect("signal", obj, "method") — use signal.connect(callable). Let AI audit your signal architecture, find disconnected signals, and visualize the signal flow across your project.
analyze_signal_flow find_signal_connections get_signals connect_signalLet AI play-test your game. Launch the game, simulate keyboard/mouse input, capture screenshots, assert game state, and run stress tests with random input. No test framework required — MCP Pro handles it all at the editor level.
play_scene simulate_key capture_frames assert_node_state run_stress_testGodot 4's AnimationTree is powerful but complex. Let AI create state machines with transitions, set up blend trees, configure conditions, and wire parameters — the most common stumbling block for Godot beginners, solved in minutes.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterGodot 4 renamed PhysicsBody to CharacterBody/RigidBody and changed collision layer APIs. Let AI set up collision shapes, configure physics layers properly, add raycasts, and audit your collision setup — avoiding the most common physics bugs.
setup_collision set_physics_layers setup_physics_body get_collision_infoGodot 4 replaced CPUParticles default with GPUParticles2D/3D. Create fire, smoke, rain, snow, and sparks with built-in presets, or fine-tune emission shape, velocity curves, and color gradients — all through natural language prompts.
create_particles apply_particle_preset set_particle_color_gradient set_particle_materialConnect your AI assistant to Godot in under 5 minutes.
Copy addons/godot_mcp/ into your Godot project. Enable it in Project > Project Settings > Plugins. The plugin starts a WebSocket server inside the editor automatically.
Run npm install && npm run build in the server/ directory. This compiles the TypeScript MCP server that bridges your AI client to the Godot plugin.
Add the server to your AI client's MCP config. Open Godot, and your AI assistant now has real-time access to 163 tools — creating scenes, editing scripts, simulating input, and analyzing your running game.
Everything you need to let AI build, inspect, test, and modify your Godot project in 2D and 3D.
get_project_info metadata & autoloadsget_filesystem_tree recursive file treesearch_files fuzzy/glob searchget/set_project_settings read & writeuid_to_project_path UID conversionproject_path_to_uid path conversionget_scene_tree live hierarchyget_scene_file_content raw .tscncreate_scene new scenesopen_scene delete_scene save_sceneadd_scene_instance prefab-like instancingplay_scene stop_sceneadd_node delete_node rename_nodeduplicate_node deep copymove_node reparentupdate_property smart type parsingget_node_properties inspect all propsadd_resource shapes, materialsset_anchor_preset UI anchorsconnect_signal disconnect_signallist_scripts project-wide overviewread_script create_scriptedit_script search/replace & insertattach_script attach to nodesget_open_scripts editor awarenessget_editor_errors errors & stack tracesget_editor_screenshot editor viewportget_game_screenshot running gamecompare_screenshots visual diff NEWexecute_editor_script run GDScriptget_signals inspect signal connectionsreload_plugin reload_projectclear_outputsimulate_key keyboard with modifierssimulate_mouse_click positioned clickssimulate_mouse_move absolute/relativesimulate_action Godot InputActionssimulate_sequence multi-event combosget_game_scene_tree live game hierarchyget/set_game_node_properties runtime inspection & tweakingexecute_game_script run code in live gamecapture_frames multi-frame screenshotsmonitor_properties property timelinestart/stop/replay_recording input recording & replay NEWfind_nodes_by_script get_autoloadfind_ui_elements click_button_by_text NEWwait_for_node batch_get_properties NEWlist_animations create_animationadd_animation_track value/position/bezierset_animation_keyframe insert keysget_animation_info tracks & keyframesremove_animationcreate_animation_tree with state machine rootget_animation_tree_structure full tree inspectionadd/remove_state_machine_state manage statesadd/remove_state_machine_transition with conditionsset_blend_tree_node Add2, Blend2, TimeScaleset_tree_parameter conditions & blendstilemap_set_cell place tilestilemap_fill_rect fill regionstilemap_get_cell read tile datatilemap_clear clear alltilemap_get_info tile set sourcestilemap_get_used_cells query used cellsadd_mesh_instance primitives & .glb/.gltf importsetup_lighting sun/indoor/dramatic presetsset_material_3d full PBR material setupsetup_environment sky, fog, glow, SSAO, SSRsetup_camera_3d projection, FOV, cull maskadd_gridmap GridMap with MeshLibrarysetup_collision auto-detect 2D/3D shapesset/get_physics_layers layer & mask managementadd_raycast RayCast2D/3Dsetup_physics_body CharacterBody & RigidBody configget_collision_info full collision auditcreate_particles GPUParticles 2D/3Dset_particle_material direction, velocity, emission shapeset_particle_color_gradient color ramp stopsapply_particle_preset fire, smoke, rain, snow, sparksget_particle_info full config inspectionsetup_navigation_region auto-detect 2D/3Dbake_navigation_mesh mesh baking & polygon gensetup_navigation_agent pathfinding & avoidanceset_navigation_layers layer managementget_navigation_info full nav auditget_audio_bus_layout full bus overviewadd_audio_bus set_audio_bus create & configureadd_audio_bus_effect reverb, delay, compressor, EQadd_audio_player 2D/3D audio playersget_audio_info subtree audio auditcreate_theme new Theme resourceset_theme_color color overridesset_theme_constant constant overridesset_theme_font_size font sizesset_theme_stylebox StyleBoxFlatget_theme_info inspect overridescreate_shader with templatesread_shader edit_shaderassign_shader_material to nodesset_shader_param set uniformsget_shader_params read all paramsread_resource inspect .tres propertiesedit_resource modify & savecreate_resource new .tres of any typefind_nodes_by_type search by classfind_signal_connections audit signalsbatch_set_property bulk changesfind_node_references cross-file searchget_scene_dependencies dependency graphcross_scene_set_property project-wide changes NEWrun_test_scenario automated test sequencesassert_node_state property assertionsassert_screen_text UI text verificationrun_stress_test random input fuzzingget_test_report pass/fail summaryfind_unused_resources dead asset detectionanalyze_signal_flow signal graph mappinganalyze_scene_complexity node count & depthfind_script_references cross-project searchdetect_circular_dependencies cycle detectionget_project_statistics full project overviewget_performance_monitors FPS, memory, physicsget_editor_performance quick summarylist_export_presets configured presetsexport_project build commandsget_export_info paths & templatesFeatures that free alternatives don't have.
Connect, disconnect, and inspect signals between nodes. No competitor supports this. Essential for Godot's event-driven architecture.
Every mutation goes through Godot's UndoRedo system. Ctrl+Z everything the AI does. Free alternatives modify scenes directly with no undo.
Vector2(100,200), #ff0000, Color(1,0,0) — the AI sends strings, we parse them into proper Godot types automatically.
WebSocket with heartbeat, auto-reconnect (exponential backoff), and port auto-scanning. No dropped connections, no manual restarts.
Errors include structured codes and actionable suggestions. The AI can self-correct instead of getting stuck on cryptic failures.
11 node tools: add, delete, rename, duplicate, move/reparent, update properties, add resources, set anchors. No competitor covers all of these.
Let AI play your game. Simulate keyboard, mouse, and InputActions. Record input sessions and replay them for regression testing with frame-precise timing.
15 tools for live game inspection. Read and modify properties at runtime, capture frames, monitor property changes, find UI elements, click buttons by text, and wait for nodes to appear.
Create animations, add tracks, insert keyframes. Build state machines with transitions and conditions. Configure blend trees with Add2, Blend2, and TimeScale nodes.
Add meshes (primitives or .glb/.gltf), set up lighting with presets, configure PBR materials, create environments with sky/fog/SSAO/SSR, place cameras, and build GridMaps.
Set up collision shapes, configure physics bodies, manage collision layers, add raycasts. Create navigation regions, bake nav meshes, configure pathfinding agents.
Create GPU particle systems with presets (fire, smoke, rain, snow). Manage audio buses, add effects (reverb, delay, compressor), and place 2D/3D audio players.
Create shaders from templates, edit GLSL code, assign ShaderMaterials, and tweak uniforms at runtime. Full shader workflow without leaving the AI chat.
Run automated test scenarios with input simulation and assertions. Verify UI text on screen. Stress test with random input fuzzing. Generate pass/fail test reports.
Find unused resources, map signal flows, analyze scene complexity, detect circular dependencies, search script references, and get full project statistics.
Find nodes by type, audit signal connections, bulk-set properties across scenes, search across all project files, and analyze dependencies. Refactor at scale.
Real examples of what you can ask your AI assistant to do — and it just works.
AI creates scenes, writes scripts, connects signals, sets up the UI, and runs the game — all in one conversation. Watch the demo video.
AI adds meshes, configures lighting presets, sets up PBR materials, and tweaks environment settings — all through the editor API with full undo/redo.
AI launches the game, simulates keyboard input, captures screenshots, inspects runtime node properties, and verifies game state — enabling automated QA workflows.
AI reads the editor's error output and script compile errors, identifies the issue, edits the script to fix it, and verifies the fix — a tight feedback loop without copy-pasting error messages.
AI creates GPU particles, configures emission shape and velocity, applies color gradients, or uses built-in presets (fire, smoke, rain, snow, sparks) for instant results.
AI searches across all scenes, finds matching nodes, and applies bulk property changes — tasks that would take minutes of manual clicking done in seconds.
How Godot MCP Pro stacks up against alternatives.
| Feature | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| Total Tools | 163 | ~30 | 13 |
| Categories | 23 | ~8 | 4 |
| Connection | WebSocket + heartbeat | WebSocket | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| Signal Management | Yes | No | No |
| Node Rename/Duplicate/Move | Yes | No | No |
| Smart Type Parsing | Yes | Limited | No |
| Input Simulation | Key / Mouse / Action / Sequence | No | No |
| Runtime Analysis | 15 tools (tree, props, frames, UI, recording) | No | No |
| 3D Scene Tools | Mesh, Lighting, PBR, Environment, Camera | No | No |
| Physics Setup | Collision, Layers, Raycasts, Bodies | No | No |
| Particles | GPU 2D/3D with presets | No | No |
| Navigation | Region, Mesh baking, Agent | No | No |
| Audio | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| Automated Testing | Scenarios, Assertions, Stress test | No | No |
| Code Analysis | Unused resources, Signal flow, Complexity | No | No |
| Screenshots | Editor + Game + Visual diff | Yes | No |
Common questions about Godot MCP Pro.
Godot MCP Pro is a premium MCP (Model Context Protocol) server that connects AI assistants like Claude, Cursor, and Cline directly to the Godot 4 editor via WebSocket. It provides 163 tools across 23 categories for scene manipulation, animation, 3D modeling, physics setup, particle effects, audio management, shader editing, input simulation, runtime analysis, and automated testing.
Install the Godot MCP Pro plugin in your project, enable it in Project Settings > Plugins, build the MCP server with npm install && npm run build, and add it to your .mcp.json. Claude (Code or Desktop) will automatically connect to the Godot editor via WebSocket and have access to all 163 tools.
Any MCP-compatible AI client works, including Claude Code, Claude Desktop, Cursor, VS Code with Cline extension, Windsurf, and other tools that support the Model Context Protocol standard. The MCP protocol is an open standard, so new clients are added regularly.
Yes. Godot MCP Pro includes dedicated 3D tools for adding mesh primitives or importing .glb/.gltf models, setting up lighting with presets, configuring PBR materials, creating environments with sky/fog/SSAO/SSR, placing cameras, and building GridMaps. Combined with physics, navigation, and particle tools, AI can build complete 3D game scenes.
Yes. The runtime analysis suite includes 15 tools that let AI launch your game, simulate keyboard/mouse/action input, capture screenshots, inspect the live scene tree, read and modify properties at runtime, record and replay input sessions, find UI elements, click buttons by text, and run automated test scenarios with assertions.
Yes. Godot MCP Pro works with Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop, and any other MCP-compatible client. Configure the MCP server in your editor's settings and it connects via WebSocket.
Godot 4.4 or later (tested on Godot 4.6) and Node.js 18+. Works on Windows, macOS, and Linux.
Godot MCP Pro offers 163 tools compared to 13-32 in free alternatives. Exclusive features include full undo/redo, signal management, input simulation with recording/replay, 15-tool runtime analysis suite, 3D scene building, physics setup, particle systems, audio bus management, navigation mesh tools, AnimationTree state machines, automated testing, and code analysis.
Yes. The GDScript editor plugin (addons/godot_mcp/) is fully open source and available on GitHub. You can inspect exactly how the plugin communicates with the editor before purchasing. The MCP server (TypeScript) is included in the paid download.
No. Godot MCP Pro is a one-time $5 purchase with lifetime updates for v1.x, unlimited projects, unlimited machines, and Discord support. No recurring fees, no seat limits.
Get up and running in under 5 minutes.
Copy the addons/godot_mcp/ folder from the download into your Godot project's root directory. Then enable the plugin:
Project > Project Settings > Plugins > Godot MCP Pro > Enable
Open a terminal in the server/ directory:
cd server npm install npm run build
Add the server to your AI client's MCP configuration file (e.g., .mcp.json for Claude Code):
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
Open your Godot project with the plugin enabled. The status panel in the editor dock shows the connection state. Start your AI assistant and begin building — it now has direct access to 163 tools in your Godot editor.
Pay once, use forever. Lifetime updates for v1.x included.