Godot MCP Bridge
The Godot MCP Bridge server enables AI assistants (Claude, Cursor, Copilot, etc.) to control and interact with the Godot 4 game editor through 168+ tools, allowing game development via natural language commands.
Connection Management
Connect/disconnect/check status of the WebSocket bridge to a running Godot editor
Send custom low-level commands via
godot_commandas an escape hatch
Project Management
Read/write project settings, browse filesystem trees, search files by pattern
Convert between UIDs and
res://paths, get autoload and metadata info
Scene Operations
Create, open, save, delete, play, and stop scenes
Get scene hierarchy (editor and runtime), instance scenes as child nodes
Node Manipulation
Add, delete, duplicate, rename, reparent, and update properties on nodes
Attach resources, set Control anchor presets, manage signals and groups
Full Undo/Redo support on all mutations
Script Management
List, read, create, edit, attach, and validate GDScript files
Search text across project files, list scripts open in the editor
Editor Interaction
Capture editor/game viewport screenshots, execute GDScript in editor or game context
Read error/output logs, clear console, reload plugins or the entire project
Input Simulation
Simulate keyboard events, mouse clicks/movement, and Godot Input actions
Run input sequences with delays, record and replay input sessions
List, create, and update input actions
Runtime Game Inspection & Modification
Read/set runtime node properties (single or batch), get the runtime scene tree
Execute scripts in game context, capture frames, monitor property values over time
Find UI elements, click buttons by text, wait for nodes to appear, navigate actors
Animation System
List, create, and remove animations in AnimationPlayer
Add tracks, set keyframes, get detailed animation info
TileMap Operations
Set, get, fill, and clear tile cells; get tilemap metadata and list used cells
Theme & UI Styling
Create theme resources, set color/constant/font size/StyleBox overrides
Performance & Profiling
Get real-time performance monitor values (FPS, memory, physics, rendering)
Get editor performance summaries and analyze scene complexity
Batch & Analysis
Find nodes by class type, script, or signal connections
Batch-get/set properties across multiple nodes, inspect all signals and connections
Key Features
Smart type parsing for Godot types (Vector2, Color, booleans, etc.)
Auto 2D/3D detection for physics, audio, and navigation nodes
Built-in presets for lighting, particles, shaders, and audio effects
JSON-RPC 2.0 over WebSocket bridge protocol
Provides 168 AI-powered tools for the Godot 4 Editor, enabling AI assistants to build games with natural language by creating scenes, editing scripts, simulating input, and analyzing running games.
Integrates with Godot 4.2+ editor via WebSocket bridge, providing 168 tools across 25 categories for scene manipulation, script editing, animation, physics, audio, and game testing through AI assistants.
Runs the TypeScript MCP server that bridges AI clients to the Godot editor plugin, handling communication between AI assistants and Godot's WebSocket server.
Supports SVG textures in Godot scenes through the update_property tool, allowing AI assistants to set SVG files as textures on nodes like Sprite2D.
Used to implement the MCP server that bridges AI clients to the Godot editor plugin, providing the tool definitions and WebSocket communication layer.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Godot MCP Bridge add a player node to the current scene"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Godot MCP Pro
168 AI-powered tools for the Godot 4 Editor — connect your AI assistant (Claude, Cursor, Cline, Copilot) to Godot and build games with natural language.
How It Works
Connect your AI assistant to Godot in under 5 minutes.
1. Install the Plugin
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.
2. Build the MCP Server
cd server
npm install && npm run buildThis compiles the TypeScript MCP server that bridges your AI client to the Godot plugin.
3. Start Building with AI
Add the server to your AI client's MCP config. Open Godot, and your AI assistant now has real-time access to 168 tools — creating scenes, editing scripts, simulating input, and analyzing your running game.
Related MCP server: godot-mcp
MCP Client Config
Claude Code / Claude Desktop
Add to .claude/mcp.json:
{
"mcpServers": {
"godot": {
"command": "node",
"args": ["/absolute/path/to/server/dist/index.js"]
}
}
}VS Code / Cursor
Add to .vscode/mcp.json:
{
"servers": {
"godot": {
"command": "node",
"args": ["./server/dist/index.js"]
}
}
}Any stdio MCP Client
node server/dist/index.jsThe server communicates over stdio (stdin/stdout) using the MCP protocol.
Automated Setup (recommended)
cd server
npm run runThis will automatically:
Build the MCP server
Detect
project.godotin parent folders (orGODOT_PROJECT_PATH)Sync addon to
addons/godot_mcpEnable plugin in
project.godotCreate MCP config files
Sync AI context files
Tool Categories
# | Category | Tools | Highlights |
1 | Project | 7 | Settings read/write, UID conversion |
2 | Scene | 9 | Create, open, play, stop, instance, save |
3 | Node | 14 | Add/delete/rename/move with UndoRedo, signals, groups |
4 | Script | 8 | CRUD, attach, validate, search with line numbers |
5 | Editor | 10 | Screenshots, execute GDScript, error log, reload |
6 | Input | 7 | Keyboard, mouse, action simulation, sequences |
7 | Runtime | 19 | Game inspection, frame capture, recording/replay, UI |
8 | Animation | 6 | CRUD, tracks, keyframes |
9 | AnimationTree | 8 | State machine, transitions, blend tree |
10 | TileMap | 6 | Cell operations (TileMapLayer for Godot 4.3+) |
11 | 3D Scene | 6 | Mesh primitives, .glb import, lighting presets, PBR |
12 | Physics | 6 | Auto 2D/3D collision, raycasts, layers |
13 | Particles | 5 | GPU particles + fire/smoke/rain/snow/sparks presets |
14 | Navigation | 6 | Region, agent, bake, pathfinding |
15 | Audio | 6 | Player (auto 2D/3D), bus effects chain |
16 | Theme/UI | 6 | StyleBoxFlat, color/constant/font overrides |
17 | Shader | 6 | Templates (canvas_item, spatial, particles, sky) |
18 | Resource | 6 | .tres CRUD, autoload management |
19 | Batch | 8 | Find by type, bulk set, dependency analysis |
20 | Testing | 6 | Automated scenarios, assertions, stress testing |
21 | Analysis | 4 | Scene complexity, signal flow, unused resources |
22 | Profiling | 2 | FPS, memory, physics, rendering monitors |
23 | Export | 3 | Preset listing, build commands |
Total | 168 | + 4 core connection tools |
Key Features
🧠 Smart Type Parsing
No need to construct complex objects manually. Property values auto-convert:
"Vector2(100, 200)" → Vector2(100, 200)
"Color(1, 0, 0)" → Color(1, 0, 0)
"#ff0000" → Color(1, 0, 0)
"Color.RED" → Color(1, 0, 0)
"true" → true
"42" → 42♻️ Undo/Redo on All Mutations
Every add_node, delete_node, update_property, rename_node, and move_node goes through Godot's UndoRedo system. Your users can Ctrl+Z any AI action.
🎯 Auto 2D/3D Detection
Physics bodies, collision shapes, audio players, particles, and navigation nodes automatically detect whether the parent is 2D or 3D — the right type is created every time.
🔥 Built-in Presets
Lighting: sun, indoor, dramatic, spot
Particles: fire, smoke, rain, snow, sparks
Shaders: canvas_item, spatial, particles, sky templates
Audio effects: reverb, delay, compressor, EQ, distortion, chorus, phaser
Quick Example
AI: godot_connect
AI: create_scene path="res://scenes/level.tscn" rootType="Node2D"
AI: add_node type="CharacterBody2D" name="Player" parentPath="."
AI: add_node type="Sprite2D" name="Sprite" parentPath="Player"
AI: update_property path="Player/Sprite" property="texture" value="res://icon.svg"
AI: setup_collision path="Player" shapeType="rectangle" size="Vector2(32, 32)"
AI: create_script path="res://scripts/player.gd" content="extends CharacterBody2D..."
AI: attach_script nodePath="Player" scriptPath="res://scripts/player.gd"
AI: save_scene
AI: play_scene
AI: simulate_key key="Space"
AI: get_game_screenshot
AI: stop_sceneArchitecture
server/src/
├── index.ts TypeScript MCP server (stdio transport)
├── toolCatalog.ts 168 tool definitions with input schemas
└── godotBridge.ts WebSocket client → Godot editor
addons/godot_mcp/
├── plugin.gd Plugin entry point
├── websocket_server.gd Local WebSocket server (port 6505)
├── command_router.gd Loads 20 handler modules, dispatches commands
└── commands/
├── base_commands.gd Shared utilities (type parser, undo, I/O)
├── type_parser.gd Smart string→Godot type conversion
├── undo_helper.gd UndoRedo wrapper
├── core_commands.gd Project, scene, node, script, editor (47 handlers)
├── editor_commands.gd Screenshots, execute script (4)
├── input_commands.gd Input simulation (7)
├── runtime_commands.gd Game inspection & UI (15)
├── animation_commands.gd Animation CRUD (6)
├── animation_tree_commands.gd State machine & blend tree (8)
├── tilemap_commands.gd Tile operations (6)
├── scene3d_commands.gd 3D scene building (6)
├── physics_commands.gd Physics & collision (6)
├── particles_commands.gd GPU particles + presets (5)
├── navigation_commands.gd Nav regions & pathfinding (6)
├── audio_commands.gd Audio players & bus effects (6)
├── theme_commands.gd Theme & UI styling (6)
├── shader_commands.gd Shader management (4)
├── resource_commands.gd Resource & autoload (6)
├── batch_commands.gd Batch operations (8)
├── testing_commands.gd Testing & QA (5)
├── analysis_commands.gd Code analysis (4)
├── profiling_commands.gd Performance profiling (2)
└── export_commands.gd Export management (3)Bridge Protocol
JSON-RPC 2.0 over WebSocket (ws://127.0.0.1:6505):
→ { "jsonrpc": "2.0", "id": 1, "method": "add_node", "params": { "type": "Sprite2D", "name": "Player" } }
← { "jsonrpc": "2.0", "id": 1, "result": { "tool": "add_node", "data": { "path": "/root/Main/Player" } } }Override bridge URL: GODOT_WS_URL=ws://127.0.0.1:6505 node server/dist/index.js
Requirements
Godot 4.2+ (4.3+ recommended for TileMapLayer)
Node.js 18+
Any MCP-compatible AI client
AI Agent Context Files
When deployed to a Godot project, these context files help AI assistants understand the available tools:
File | Purpose | Used by |
| Complete 168-tool reference with workflows | All AI agents |
| Architecture + capability summary | Codex, Gemini, agents |
| Quick reference + build commands | Claude Code |
| Copilot-specific instructions | GitHub Copilot |
References
Available Tools
167 toolsadd_animation_trackD
Add animation track. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_audio_busD
Add audio bus. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_audio_bus_effectC
Add effect to audio bus. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_audio_playerC
Add AudioStreamPlayer node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_autoloadC
Register autoload singleton. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_gridmapC
Create GridMap node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_mesh_instanceC
Add MeshInstance3D with primitive mesh. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_nodeC
Add node with type and optional properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_raycastC
Add RayCast2D or RayCast3D. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_resourceC
Attach resource to node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_scene_instanceC
Instance scene as a child node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_state_machine_stateC
Add AnimationTree state machine state. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
add_state_machine_transitionD
Add state machine transition. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
analyze_scene_complexityC
Analyze scene complexity metrics. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
analyze_signal_flowC
Analyze signal graph in project. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
apply_particle_presetC
Apply particle effect preset. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
assert_node_stateC
Assert node property value. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
assert_screen_textC
Assert screen text is visible. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
assign_shader_materialC
Assign ShaderMaterial to node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
attach_scriptC
Attach script to node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
batch_get_propertiesC
Read multiple node properties in batch. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
batch_set_propertyC
Batch set property by filter. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
capture_framesC
Capture multiple game frames. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
clear_outputC
Clear output panel. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
click_button_by_textC
Click button by text content. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
compare_screenshotsD
Compare screenshots. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
connect_signalC
Connect node signal. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_animationC
Create new animation. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_animation_treeC
Create AnimationTree node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_particlesD
Create GPUParticles2D or GPUParticles3D. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_resourceC
Create resource file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_sceneC
Create a new scene file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_scriptC
Create a script file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_shaderB
Create shader file from template. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
create_themeC
Create theme resource. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
cross_scene_set_propertyC
Set property across scenes. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
delete_nodeC
Delete node from scene. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
delete_sceneC
Delete a scene file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
detect_circular_dependenciesC
Detect dependency cycles. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
disconnect_signalC
Disconnect node signal. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
duplicate_nodeC
Duplicate node and children. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
edit_resourceC
Edit resource properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
edit_scriptC
Edit script with replace or full content. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
edit_shaderD
Edit shader file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
execute_editor_scriptC
Execute GDScript in editor context. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
execute_game_scriptC
Execute script in game context. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
export_projectC
Get export command or trigger export. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_nearby_nodesC
Find nearby nodes by position. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_node_referencesC
Search node references in files. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_nodes_by_scriptC
Find runtime nodes by script. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_nodes_by_typeC
Find nodes by class type. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_nodes_in_groupC
Find nodes in a group. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_script_referencesD
Find script references. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_signal_connectionsD
Find signal connections. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_ui_elementsC
Find UI elements in game. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
find_unused_resourcesC
Find unreferenced resources. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_animation_infoD
Get animation details. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_animation_tree_structureC
Inspect AnimationTree structure. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_audio_bus_layoutC
Get audio bus layout. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_audio_infoC
Get audio node information. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_autoloadC
Get autoload node details. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_collision_infoC
Get collision shape information. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_editor_errorsC
Get editor errors and stack traces. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_editor_performanceC
Get editor performance summary. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_editor_screenshotC
Capture editor viewport screenshot. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_export_infoC
Get export configuration info. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_filesystem_treeC
Get recursive file tree with optional filters. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_game_node_propertiesC
Read runtime node properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_game_scene_treeC
Get runtime scene hierarchy. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_game_screenshotC
Capture running game screenshot. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_input_actionsC
List input actions. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_node_groupsD
Get node groups. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_node_propertiesC
Get node properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_open_scriptsC
List scripts open in editor. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_output_logC
Get editor output log. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_particle_infoC
Get particle system details. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_performance_monitorsC
Get performance monitor values. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_physics_layersC
Get collision layer and mask. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_project_infoC
Get project metadata and autoload information. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_project_settingsC
Read project settings. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_project_statisticsC
Get project statistics summary. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_resource_previewC
Get resource preview thumbnail. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_scene_dependenciesD
Get scene dependencies. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_scene_file_contentC
Read raw .tscn content. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_scene_treeC
Get scene hierarchy from editor/runtime. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_shader_paramsC
Get shader params from material. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_signalsC
Inspect node signals and connections. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_test_reportC
Get test report. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
get_theme_infoC
Get theme override info. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
godot_commandA
Send a custom command to Godot bridge. This is a low-level escape hatch when a named tool is not enough.
Inputs: command (required), payload, timeoutMs, autoConnect.
godot_connectC
Connect to a running Godot bridge over WebSocket.
Inputs: timeoutMs.
godot_disconnectB
Disconnect from the Godot bridge.
Inputs: no named parameters.
godot_statusA
Return current connection status to the Godot bridge.
Inputs: no named parameters.
list_animationsC
List animations in AnimationPlayer. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
list_export_presetsC
List export presets. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
list_scriptsC
List scripts in project. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
monitor_propertiesC
Monitor property values over time. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
move_nodeC
Move or reparent node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
move_toC
Move actor to target. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
open_sceneC
Open a scene in editor. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
play_sceneC
Run scene from editor. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
project_path_to_uidC
Convert res:// path to UID. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
read_resourceC
Read resource properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
read_scriptC
Read script file content. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
read_shaderC
Read shader file. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
reload_pluginC
Reload plugin and reconnect bridge. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
reload_projectC
Rescan and reload project. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
remove_animationC
Remove animation. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
remove_autoloadC
Unregister autoload singleton. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
remove_state_machine_stateC
Remove state machine state. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
remove_state_machine_transitionC
Remove state machine transition. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
rename_nodeC
Rename node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
replay_recordingC
Replay recorded input. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
run_stress_testC
Run stress input test. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
run_test_scenarioC
Run automated test scenario. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
save_sceneC
Save current scene. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
search_filesC
Search files by pattern or glob. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
search_in_filesC
Search text across files. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_anchor_presetC
Set anchor preset for Control node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_animation_keyframeC
Set keyframe value. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_audio_busC
Configure audio bus properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_blend_tree_nodeD
Configure blend tree node. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_game_node_propertiesC
Set multiple runtime node properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_game_node_propertyC
Set runtime node property. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_input_actionC
Create or update input action. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_material_3dC
Set StandardMaterial3D properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_node_groupsD
Set node groups. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_particle_color_gradientC
Set particle color gradient. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_particle_materialC
Configure particle process material. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_physics_layersC
Set collision layer and mask. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_project_settingC
Set a project setting value. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_shader_paramC
Set shader uniform value. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_theme_colorC
Set theme color override. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_theme_constantC
Set theme constant override. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_theme_font_sizeD
Set theme font size override. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_theme_styleboxD
Set theme stylebox override. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
set_tree_parameterC
Set AnimationTree parameter. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
setup_camera_3dC
Set Camera3D properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
setup_collisionC
Add collision shapes. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
setup_environmentC
Configure world environment. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
setup_lightingC
Set up lighting nodes. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
setup_physics_bodyC
Configure physics body properties. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
simulate_actionC
Simulate Godot Input action. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
simulate_keyC
Simulate keyboard input. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
simulate_mouse_clickC
Simulate mouse click. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
simulate_mouse_moveC
Simulate mouse movement. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
simulate_sequenceC
Run input sequence with delays. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
start_recordingC
Start input recording. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
stop_recordingC
Stop input recording. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
stop_sceneC
Stop running scene. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_clearC
Clear all tilemap cells. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_fill_rectC
Fill tile rectangle. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_get_cellC
Get tile cell data. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_get_infoC
Get tilemap metadata. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_get_used_cellsC
List used tile cells. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
tilemap_set_cellC
Set single tile cell. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
uid_to_project_pathC
Convert UID to res:// project path. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
update_propertyD
Update node property. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
validate_scriptC
Validate script syntax. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
wait_for_nodeC
Wait for node to appear. (Compatibility tool)
Inputs: timeoutMs, autoConnect.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 167 tools
With 167 tools, significant overlap exists between generic utilities (add_node) and specific variants (add_mesh_instance, add_audio_player). Multiple property accessors (get_node_properties, batch_get_properties, get_game_node_properties) operate in different contexts but have minimal descriptions that fail to clarify when to use each, causing high risk of misselection.
While predominantly using snake_case verb_noun patterns, inconsistencies emerge with tilemap_* prefixing, godot_* prefixing for connection tools, and mixed verb choices (add/create/remove/delete). Some tools use noun_verb ordering (uid_to_project_path) while others use verb_noun, and similar operations lack parallel structure (cross_scene_set_property vs batch_set_property).
At 167 tools, this vastly exceeds the 50+ threshold for extreme mismatch. Despite Godot's complexity, this quantity will overwhelm agent context windows and selection logic. A more coherent design would use fewer tools with parameters rather than discrete endpoints for every operation.
The set provides extensive coverage across Godot subsystems including scene management, scripting, animation, audio, physics, UI, and testing. While the granularity is inconsistent (some operations have specific tools while others rely on generic ones), there appear to be few functional gaps for core game engine workflows.
Maintenance
Related MCP Connectors
AI game maker: build, run, screenshot and play-test Godot and retro console games in a live project
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Discover AI tools for game development — 100+ tools indexed by engine, task, and pricing.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceEnables AI agents to fully control the Forge Engine (Godot fork) by manipulating scene trees, modifying node properties, and managing game scripts. It allows agents to perform development tasks such as running projects, capturing screenshots, and executing GDScript through a WebSocket connection.21-
- AlicenseCqualityDmaintenanceProvides AI assistants with full control over the Godot game engine through 157 operations including scene manipulation, runtime code execution, input simulation, and project management.19197 npmMIT
- AlicenseAqualityCmaintenanceMCP bridge between an AI assistant and the Godot editor, enabling control via 6 tools (call methods, run GDScript, screenshots, etc.) over WebSocket.1011 npm3MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to interact with the Godot Engine editor and projects, including scene editing, script management, physics queries, and asset operations.1261MIT