Godot MCP Pro

youichi-uda634stars

162 MCP tools for AI-powered Godot 4 development. Scene, animation, 3D, physics, particles, audio, shader, input simulation, runtime analysis, navigation, testing & more. $15 one-time.

Ai Tools Claude Cursor Game Development

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Godot MCP Pro

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: NOASSERTION
Last checked: 2026-10-27

Stars: 634
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Godot MCP Pro?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Godot MCP Pro need an API key?

No required environment variable is listed on this record.

What transport does Godot MCP Pro use?

Godot MCP Pro runs locally over stdio.

When was Godot MCP Pro last checked?

Last checked 2026-10-27. 162 MCP tools for AI-powered Godot 4 development. Scene, animation, 3D, physics, particles, audio, shader, input simulation, runtime analysis, navigation, testing & more. $15 one-time.

From the publisher

Documentation

Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 187 powerful tools.

Architecture

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

Real-time: WebSocket connection means instant feedback, no file polling
Editor Integration: Full access to Godot's editor API, UndoRedo system, and scene tree
JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

What's in this repo

⚠️ This public repo only contains the free Godot addon/plugin. The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package — one-time purchase, lifetime updates:

Buy Me a Coffee: https://buymeacoffee.com/y1uda/extras

itch.io: https://y1uda.itch.io/godot-mcp-pro

The paid zip includes the addon, the server/ directory with pre-built JavaScript, INSTALL.md, and AI-client instructions. If you cloned this repo and don't see a server/ folder, that's expected — grab the full package from one of the links above.

Quick Start

1. Install the Godot Plugin

Copy the addons/godot_mcp/ folder into your Godot project's addons/ directory.

Enable the plugin: Project → Project Settings → Plugins → Godot MCP Pro → Enable

2. Install the MCP Server

The server/ directory is only included in the full paid package (see above). After downloading and extracting the zip, run:

cd server
npm install
npm run build

3. Configure Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4. Choose Your Mode

Godot MCP Pro offers four modes to fit any client's tool limit:

Mode	Tools	Best For
Full (default)	187	Claude Code, Cline, VS Code Copilot, Cursor
3D (`--3d`)	100	Antigravity and other 100-tool-limit clients needing 3D
Lite (`--lite`)	88	Windsurf, JetBrains Junie, Gemini CLI
Minimal (`--minimal`)	35	OpenCode, local LLMs with small context

--3d includes the core tools plus physics, AnimationTree and navigation, but omits uid_to_project_path, project_path_to_uid, compare_screenshots, clear_output, close_script, reload_open_scripts, set_anchor_preset and click_button_by_text to stay within the 100-tool cap.

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

Replace --lite with --minimal for the smallest footprint.

Lite includes: project, scene, node, script, editor, input, runtime, and input_map tools.
Minimal includes: 35 essential tools — project info, scene management, node CRUD, script editing, editor errors, input simulation, and runtime inspection.

5. CLI Mode (Alternative to MCP)

For clients without MCP support, or when you want zero context overhead, use the CLI directly from a terminal/bash tool. The CLI requires the server to be built first (Step 2).

# Top-level help — shows all command groups
node /path/to/server/build/cli.js --help

# Group help — shows commands in a group
node /path/to/server/build/cli.js node --help

# Command help — shows options for a command
node /path/to/server/build/cli.js node add --help

# Execute
node /path/to/server/build/cli.js project info
node /path/to/server/build/cli.js scene play
node /path/to/server/build/cli.js node add --type CharacterBody3D --name Player

Replace /path/to/ with the actual path where you extracted the files.

The CLI connects directly to the Godot editor plugin via WebSocket. It requires:

Godot editor running with the MCP plugin enabled
Server built (node build/setup.js install)
An available port in the 6510-6514 range

Advantage: LLMs discover capabilities progressively via --help instead of loading all tool definitions upfront. This works with any LLM client that has terminal access, regardless of tool count limits.

6. Client Compatibility

Client	Recommended Mode	Notes
Claude Code	Full (default)	Deferred tool loading — minimal context cost
VS Code Copilot	Full	Virtual Tools auto-group tools
OpenAI Codex CLI	Full	MCPSearch defers overflow
Cline	Full	No hard limit; use `enabledTools` to whitelist
Roo Code	Full	No hard limit
Windsurf	Lite	100 tool limit
JetBrains Junie	Lite	100 tool limit
Gemini CLI	Lite	~100 client limit; use `excludeTools` for finer control
Cursor	Full	Tool limit removed (Dynamic Context Discovery)
OpenCode	Minimal or CLI	Models degrade past ~40 tools
Local LLMs (LM Studio, etc.)	Minimal or CLI	Context window is the bottleneck

7. Use It

Open your Godot project with the plugin enabled, then use Claude Code to interact with the editor.

All 187 Tools

Project Tools (10)

Tool	Description
`get_project_info`	Project metadata, version, viewport, autoloads
`get_filesystem_tree`	Recursive file tree with filtering
`search_files`	Fuzzy/glob file search
`search_in_files`	Search content in project files
`get_project_settings`	Read project.godot settings
`set_project_setting`	Set project settings via editor API
`uid_to_project_path`	UID → res:// conversion
`project_path_to_uid`	res:// → UID conversion
`add_autoload`	Register autoload singleton
`remove_autoload`	Remove autoload singleton

Scene Tools (10)

Tool	Description
`get_scene_tree`	Live scene tree with hierarchy
`get_scene_file_content`	Raw .tscn file content
`create_scene`	Create new scene files
`open_scene`	Open scene in editor
`delete_scene`	Delete scene file
`add_scene_instance`	Instance scene as child node
`play_scene`	Run scene (main/current/custom)
`stop_scene`	Stop running scene
`save_scene`	Save current scene to disk
`get_scene_exports`	List @export variables of all scripted nodes in a scene file

Node Tools (17)

Tool	Description
`add_node`	Add node with type and properties
`delete_node`	Delete node (with undo support)
`duplicate_node`	Duplicate node and children
`move_node`	Move/reparent node
`update_property`	Set any property (auto type parsing)
`get_node_properties`	Get all node properties
`add_resource`	Add Shape/Material/etc to node
`set_anchor_preset`	Set Control anchor preset
`rename_node`	Rename a node in the scene
`connect_signal`	Connect signal between nodes
`disconnect_signal`	Disconnect signal connection
`get_node_groups`	Get groups a node belongs to
`set_node_groups`	Set node group membership
`find_nodes_in_group`	Find all nodes in a group
`get_editor_selection`	Get nodes selected in the Scene dock
`select_nodes`	Select (and optionally focus/inspect) nodes in the Scene dock
`clear_editor_selection`	Clear the Scene dock selection

Script Tools (9)

Tool	Description
`list_scripts`	List all scripts with class info
`read_script`	Read script content
`create_script`	Create new script with template
`edit_script`	Search/replace or full edit
`attach_script`	Attach script to node
`validate_script`	Validate GDScript syntax
`close_script`	Close a script editor tab; refuses on unsaved edits unless told to discard (Godot 4.7+)
`reload_open_scripts`	Reload open scripts from disk, keeping unsaved buffers (Godot 4.7+)
`get_open_scripts`	List scripts open in editor

Editor Tools (15)

Tool	Description
`get_editor_errors`	Get errors and stack traces
`get_output_log`	Get output panel content
`get_editor_screenshot`	Capture editor viewport
`get_game_screenshot`	Capture running game
`execute_editor_script`	Run arbitrary GDScript in editor
`clear_output`	Clear output panel
`get_signals`	Get all signals of a node with connections
`reload_plugin`	Reload the MCP plugin (auto-reconnect)
`reload_project`	Rescan filesystem and reload scripts
`compare_screenshots`	Compare two screenshots
`set_auto_dismiss`	Auto-dismiss blocking editor dialogs ("Reload from disk?" etc.)
`get_editor_camera`	Get 3D editor camera position/rotation/FOV (+ snap settings on 4.6+)
`set_editor_camera`	Move the 3D editor camera to frame a view
`get_unsaved_state`	Report open scenes/scripts with unsaved changes (unsaved lists need Godot 4.7+)
`save_all`	Save all open scenes and modified script buffers, report what was saved (scripts need Godot 4.7+)

Input Tools (5)

Tool	Description
`simulate_key`	Simulate keyboard key press/release
`simulate_mouse_click`	Simulate mouse click at position
`simulate_mouse_move`	Simulate mouse movement
`simulate_action`	Simulate Godot Input Action
`simulate_sequence`	Sequence of input events with frame delays

Input Map Tools (2)

Tool	Description
`get_input_actions`	List all input actions
`set_input_action`	Create/modify input action

Runtime Tools (20)

Tool	Description
`get_game_scene_tree`	Scene tree of running game
`get_game_node_properties`	Node properties in running game
`set_game_node_property`	Set node property in running game
`execute_game_script`	Run GDScript in game context
`capture_frames`	Multi-frame screenshot capture
`record_frames`	Record many frames to PNG files on disk
`monitor_properties`	Record property values over time
`watch_signals`	Log signal emissions on nodes over a duration
`start_recording`	Start input recording
`stop_recording`	Stop input recording
`replay_recording`	Replay recorded input
`find_nodes_by_script`	Find game nodes by script
`get_autoload`	Get autoload node properties
`find_ui_elements`	Find UI elements in game
`click_button_by_text`	Click button by text content
`wait_for_node`	Wait for node to appear
`find_nearby_nodes`	Find nodes near position
`navigate_to`	Navigate to target position
`move_to`	Walk character to target
`batch_get_properties`	Batch get multiple node properties

Animation Tools (6)

Tool	Description
`list_animations`	List all animations in AnimationPlayer
`create_animation`	Create new animation
`add_animation_track`	Add track (value/position/rotation/method/bezier)
`set_animation_keyframe`	Insert keyframe into track
`get_animation_info`	Detailed animation info with all tracks/keys
`remove_animation`	Remove an animation

TileMap Tools (6)

Tool	Description
`tilemap_set_cell`	Set a single tile cell
`tilemap_fill_rect`	Fill rectangular region with tiles
`tilemap_get_cell`	Get tile data at cell
`tilemap_clear`	Clear all cells
`tilemap_get_info`	TileMapLayer info and tile set sources
`tilemap_get_used_cells`	List of used cells

Theme & UI Tools (8)

Tool	Description
`create_theme`	Create Theme resource file
`set_theme_color`	Set theme color override
`set_theme_constant`	Set theme constant override
`set_theme_font_size`	Set theme font size override
`set_theme_stylebox`	Set StyleBoxFlat override
`setup_control`	Configure Control/Container layout in one call
`add_virtual_joystick`	Add an on-screen VirtualJoystick bound to input actions (Godot 4.7+)
`get_theme_info`	Get theme overrides info

Profiling Tools (2)

Tool	Description
`get_performance_monitors`	All performance monitors (FPS, memory, physics, etc.)
`get_editor_performance`	Quick performance summary

Batch & Refactoring Tools (7)

Tool	Description
`find_nodes_by_type`	Find all nodes of a type
`find_signal_connections`	Find all signal connections in scene
`batch_set_property`	Set property on all nodes of a type
`batch_add_nodes`	Add a whole node tree in one call
`find_node_references`	Search project files for pattern
`get_scene_dependencies`	Get resource dependencies
`cross_scene_set_property`	Set property across all scenes

Shader Tools (6)

Tool	Description
`create_shader`	Create shader with template
`read_shader`	Read shader file
`edit_shader`	Edit shader (replace/search-replace)
`assign_shader_material`	Assign ShaderMaterial to node
`set_shader_param`	Set shader parameter
`get_shader_params`	Get all shader parameters

Export Tools (4)

Tool	Description
`list_export_presets`	List export presets
`export_project`	Get export command for preset
`export_patch_pck`	Export a patch PCK with only files changed since given base packs
`get_export_info`	Export-related project info

Resource Tools (4)

Tool	Description
`read_resource`	Read .tres resource properties
`edit_resource`	Edit resource properties
`create_resource`	Create new .tres resource
`get_resource_preview`	Get resource thumbnail

Physics Tools (6)

Tool	Description
`setup_collision`	Add collision shapes to nodes
`set_physics_layers`	Set collision layer/mask
`get_physics_layers`	Get collision layer/mask info
`add_raycast`	Add RayCast2D/3D node
`setup_physics_body`	Configure physics body properties
`get_collision_info`	Get collision shape details

3D Scene Tools (7)

Tool	Description
`add_mesh_instance`	Add MeshInstance3D with primitive mesh
`setup_lighting`	Add/configure light nodes
`set_material_3d`	Set StandardMaterial3D properties
`setup_environment`	Configure WorldEnvironment
`setup_camera_3d`	Configure Camera3D properties
`add_gridmap`	Set up GridMap node
`get_gridmap_info`	Inspect a GridMap: MeshLibrary, bounds, per-item counts, filtered cells (octant summary on 4.7+)

Particle Tools (5)

Tool	Description
`create_particles`	Create GPUParticles2D/3D
`set_particle_material`	Configure ParticleProcessMaterial
`set_particle_color_gradient`	Set color gradient for particles
`apply_particle_preset`	Apply preset (fire, smoke, sparks, etc.)
`get_particle_info`	Get particle system details

Navigation Tools (5)

Tool	Description
`setup_navigation_region`	Configure NavigationRegion
`bake_navigation_mesh`	Bake navigation mesh
`setup_navigation_agent`	Configure NavigationAgent
`set_navigation_layers`	Set navigation layers
`get_navigation_info`	Get navigation setup info

Audio Tools (6)

Tool	Description
`get_audio_bus_layout`	Get audio bus layout info
`add_audio_bus`	Add audio bus
`set_audio_bus`	Configure audio bus properties
`add_audio_bus_effect`	Add effect to audio bus
`add_audio_player`	Add AudioStreamPlayer node
`get_audio_info`	Get audio-related node info

AnimationTree Tools (9)

Tool	Description
`create_animation_tree`	Create AnimationTree
`get_animation_tree_structure`	Get tree structure
`add_state_machine_state`	Add state to state machine
`remove_state_machine_state`	Remove state from state machine
`add_state_machine_transition`	Add transition between states
`remove_state_machine_transition`	Remove state transition
`set_blend_tree_node`	Configure blend tree nodes
`set_tree_parameter`	Set AnimationTree parameter
`setup_ik_modifier`	Add and configure an IK SkeletonModifier3D (TwoBoneIK3D, CCDIK3D, FABRIK3D, ...) on a Skeleton3D (Godot 4.6+)

Analysis & Search Tools (6)

Tool	Description
`find_unused_resources`	Find unreferenced resources
`analyze_signal_flow`	Map signal connections
`analyze_scene_complexity`	Analyze scene performance
`find_script_references`	Find where script/resource is used
`detect_circular_dependencies`	Find circular scene dependencies
`get_project_statistics`	Get project-wide statistics

Testing & QA Tools (6)

Tool	Description
`run_test_scenario`	Run automated test scenario
`assert_node_state`	Assert node property values
`assert_screen_text`	Check for text on screen
`run_stress_test`	Run performance stress test
`set_game_speed`	Read/set the running game's Engine.time_scale (slow motion / fast-forward)
`get_test_report`	Get test results report

Headless Tools (3)

Tool	Description
`run_headless_scene`	Run a scene in a separate headless Godot process (e.g. a project's test suite)
`run_headless_script`	Run an `extends SceneTree` script with `godot --headless --script`
`get_godot_executable`	Path of the editor's Godot binary, project path and platform

Android Tools (3)

Tool	Description
`list_android_devices`	List Android devices visible to adb
`get_android_preset_info`	Read an Android export preset's package name/export path
`deploy_to_android`	Export APK, install via adb and launch (like Remote Deploy)

Key Features

UndoRedo Integration: All node/property operations support Ctrl+Z
Smart Type Parsing: "Vector2(100, 200)", "#ff0000", "Color(1,0,0)" auto-converted
Auto-Reconnect: Exponential backoff reconnection (1s → 2s → 4s ... → 60s max)
Heartbeat: 10s ping/pong keeps connection alive
Helpful Errors: Error responses include suggestions for next steps

Competitive Comparison

Tool Count

Category	Godot MCP Pro	GDAI MCP ($19)	tomyud1 (free)	Dokujaa (free)	Coding-Solo (free)	ee0pdt (free)	bradypp (free)
Project	10	5	4	0	2	2	2
Scene	10	8	11	9	3	4	5
Node	17	8	0	8	2	3	0
Script	9	5	6	4	0	5	0
Editor	15	5	1	5	1	3	2
Input	7	2	0	0	0	0	0
Runtime	20	0	0	0	0	0	0
Animation	6	0	0	0	0	0	0
TileMap	6	0	0	0	0	0	0
Theme/UI	8	0	0	0	0	0	0
Profiling	2	0	0	0	0	0	0
Batch/Refactor	7	0	0	0	0	0	0
Shader	6	0	0	0	0	0	0
Export	4	0	0	0	0	0	0
Resource	4	0	0	0	0	0	0
Physics	6	0	0	0	0	0	0
3D Scene	7	0	0	0	0	0	0
Particle	5	0	0	0	0	0	0
Navigation	5	0	0	0	0	0	0
Audio	6	0	0	0	0	0	0
AnimationTree	9	0	0	0	0	0	0
Analysis	6	0	0	0	0	0	0
Testing/QA	6	0	0	0	0	0	0
Asset/AI	0	0	1	6	0	0	0
Material	0	0	0	2	0	0	0
Other	0	0	9	5	5	2	1
Headless	3	0	0	0	0	0	0
Android Deploy	3	0	0	0	0	0	0
Total	187	~30	32	39	13	19	10

Feature Matrix

Feature	Godot MCP Pro	GDAI MCP ($19)	tomyud1 (free)	Dokujaa (free)	Coding-Solo (free)
Connection	WebSocket (real-time)	stdio (Python)	WebSocket	TCP Socket	Headless CLI
Undo/Redo	Yes	Yes	No	No	No
JSON-RPC 2.0	Yes	Custom	Custom	Custom	N/A
Auto-reconnect	Yes (exponential backoff)	N/A	No	No	N/A
Heartbeat	Yes (10s ping/pong)	No	No	No	No
Error suggestions	Yes (contextual hints)	No	No	No	No
Screenshot capture	Yes (editor + game)	Yes	No	No	No
Game input simulation	Yes (key/mouse/action/sequence)	Yes (basic)	No	No	No
Runtime inspection	Yes (scene tree + properties + monitor)	No	No	No	No
Signal management	Yes (connect/disconnect/inspect)	No	No	No	No
Browser visualizer	No	No	Yes	No	No
AI 3D mesh generation	No	No	No	Yes (Meshy API)	No

Exclusive Categories (No Competitor Has These)

Category	Tools	Why It Matters
Animation	6 tools	Create animations, add tracks, set keyframes — all programmatically
TileMap	6 tools	Set cells, fill rects, query tile data — essential for 2D level design
Theme/UI	8 tools	StyleBox, colors, fonts — build UI themes without manual editor work
Profiling	2 tools	FPS, memory, draw calls, physics — performance monitoring
Batch/Refactor	7 tools	Find by type, batch property changes, cross-scene updates, dependency analysis
Shader	6 tools	Create/edit shaders, assign materials, set parameters
Export	4 tools	List presets, get export commands, check templates
Physics	6 tools	Set up collision shapes, bodies, raycasts, and layer management
3D Scene	7 tools	Add meshes, cameras, lights, environment, GridMap support
Particle	5 tools	Create particles with custom materials, presets, and gradients
Navigation	5 tools	Configure navigation regions, agents, pathfinding, baking
Audio	6 tools	Complete audio bus system, effects, players, live management
AnimationTree	9 tools	State machines, transitions, blend trees and IK modifiers
Testing/QA	6 tools	Automated testing, assertions, stress testing, screenshot comparison
Runtime	20 tools	Inspect and control game at runtime: inspect, record, replay, navigate

Architecture Advantages

Aspect	Godot MCP Pro	Typical Competitor
Protocol	JSON-RPC 2.0 (standard, extensible)	Custom JSON or CLI-based
Connection	Persistent WebSocket with heartbeat	Per-command subprocess or raw TCP
Reliability	Auto-reconnect with exponential backoff (1s→60s)	Manual reconnection required
Type Safety	Smart type parsing (Vector2, Color, Rect2, hex colors)	String-only or limited types
Error Handling	Structured errors with codes + suggestions	Generic error messages
Undo Support	All mutations go through UndoRedo system	Direct modifications (no undo)
Port Management	Auto-scan ports 6505-6509	Fixed port, conflicts possible

License

Proprietary — see LICENSE for details. Purchase includes lifetime updates.

Godot MCP Pro

youichi-uda634stars

162 MCP tools for AI-powered Godot 4 development. Scene, animation, 3D, physics, particles, audio, shader, input simulation, runtime analysis, navigation, testing & more. $15 one-time.

Ai Tools Claude Cursor Game Development

Install Run on PlugMCP

GitHub Website

Run on PlugMCP

1# Godot MCP Pro

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: NOASSERTION
Last checked: 2026-10-27

Stars: 634
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Godot MCP Pro?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Godot MCP Pro need an API key?

No required environment variable is listed on this record.

What transport does Godot MCP Pro use?

Godot MCP Pro runs locally over stdio.

When was Godot MCP Pro last checked?

From the publisher

Documentation

Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 187 powerful tools.

Architecture

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

Real-time: WebSocket connection means instant feedback, no file polling
Editor Integration: Full access to Godot's editor API, UndoRedo system, and scene tree
JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

What's in this repo

⚠️ This public repo only contains the free Godot addon/plugin. The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package — one-time purchase, lifetime updates:

Buy Me a Coffee: https://buymeacoffee.com/y1uda/extras

itch.io: https://y1uda.itch.io/godot-mcp-pro

The paid zip includes the addon, the server/ directory with pre-built JavaScript, INSTALL.md, and AI-client instructions. If you cloned this repo and don't see a server/ folder, that's expected — grab the full package from one of the links above.

Quick Start

1. Install the Godot Plugin

Copy the addons/godot_mcp/ folder into your Godot project's addons/ directory.

Enable the plugin: Project → Project Settings → Plugins → Godot MCP Pro → Enable

2. Install the MCP Server

The server/ directory is only included in the full paid package (see above). After downloading and extracting the zip, run:

cd server
npm install
npm run build

3. Configure Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4. Choose Your Mode

Godot MCP Pro offers four modes to fit any client's tool limit:

Mode	Tools	Best For
Full (default)	187	Claude Code, Cline, VS Code Copilot, Cursor
3D (`--3d`)	100	Antigravity and other 100-tool-limit clients needing 3D
Lite (`--lite`)	88	Windsurf, JetBrains Junie, Gemini CLI
Minimal (`--minimal`)	35	OpenCode, local LLMs with small context

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

Replace --lite with --minimal for the smallest footprint.

Lite includes: project, scene, node, script, editor, input, runtime, and input_map tools.
Minimal includes: 35 essential tools — project info, scene management, node CRUD, script editing, editor errors, input simulation, and runtime inspection.

5. CLI Mode (Alternative to MCP)

For clients without MCP support, or when you want zero context overhead, use the CLI directly from a terminal/bash tool. The CLI requires the server to be built first (Step 2).

# Top-level help — shows all command groups
node /path/to/server/build/cli.js --help

# Group help — shows commands in a group
node /path/to/server/build/cli.js node --help

# Command help — shows options for a command
node /path/to/server/build/cli.js node add --help

# Execute
node /path/to/server/build/cli.js project info
node /path/to/server/build/cli.js scene play
node /path/to/server/build/cli.js node add --type CharacterBody3D --name Player

Replace /path/to/ with the actual path where you extracted the files.

The CLI connects directly to the Godot editor plugin via WebSocket. It requires:

Godot editor running with the MCP plugin enabled
Server built (node build/setup.js install)
An available port in the 6510-6514 range

6. Client Compatibility

Client	Recommended Mode	Notes
Claude Code	Full (default)	Deferred tool loading — minimal context cost
VS Code Copilot	Full	Virtual Tools auto-group tools
OpenAI Codex CLI	Full	MCPSearch defers overflow
Cline	Full	No hard limit; use `enabledTools` to whitelist
Roo Code	Full	No hard limit
Windsurf	Lite	100 tool limit
JetBrains Junie	Lite	100 tool limit
Gemini CLI	Lite	~100 client limit; use `excludeTools` for finer control
Cursor	Full	Tool limit removed (Dynamic Context Discovery)
OpenCode	Minimal or CLI	Models degrade past ~40 tools
Local LLMs (LM Studio, etc.)	Minimal or CLI	Context window is the bottleneck

7. Use It

Open your Godot project with the plugin enabled, then use Claude Code to interact with the editor.

All 187 Tools

Project Tools (10)

Tool	Description
`get_project_info`	Project metadata, version, viewport, autoloads
`get_filesystem_tree`	Recursive file tree with filtering
`search_files`	Fuzzy/glob file search
`search_in_files`	Search content in project files
`get_project_settings`	Read project.godot settings
`set_project_setting`	Set project settings via editor API
`uid_to_project_path`	UID → res:// conversion
`project_path_to_uid`	res:// → UID conversion
`add_autoload`	Register autoload singleton
`remove_autoload`	Remove autoload singleton

Scene Tools (10)

Tool	Description
`get_scene_tree`	Live scene tree with hierarchy
`get_scene_file_content`	Raw .tscn file content
`create_scene`	Create new scene files
`open_scene`	Open scene in editor
`delete_scene`	Delete scene file
`add_scene_instance`	Instance scene as child node
`play_scene`	Run scene (main/current/custom)
`stop_scene`	Stop running scene
`save_scene`	Save current scene to disk
`get_scene_exports`	List @export variables of all scripted nodes in a scene file

Node Tools (17)

Tool	Description
`add_node`	Add node with type and properties
`delete_node`	Delete node (with undo support)
`duplicate_node`	Duplicate node and children
`move_node`	Move/reparent node
`update_property`	Set any property (auto type parsing)
`get_node_properties`	Get all node properties
`add_resource`	Add Shape/Material/etc to node
`set_anchor_preset`	Set Control anchor preset
`rename_node`	Rename a node in the scene
`connect_signal`	Connect signal between nodes
`disconnect_signal`	Disconnect signal connection
`get_node_groups`	Get groups a node belongs to
`set_node_groups`	Set node group membership
`find_nodes_in_group`	Find all nodes in a group
`get_editor_selection`	Get nodes selected in the Scene dock
`select_nodes`	Select (and optionally focus/inspect) nodes in the Scene dock
`clear_editor_selection`	Clear the Scene dock selection

Script Tools (9)

Tool	Description
`list_scripts`	List all scripts with class info
`read_script`	Read script content
`create_script`	Create new script with template
`edit_script`	Search/replace or full edit
`attach_script`	Attach script to node
`validate_script`	Validate GDScript syntax
`close_script`	Close a script editor tab; refuses on unsaved edits unless told to discard (Godot 4.7+)
`reload_open_scripts`	Reload open scripts from disk, keeping unsaved buffers (Godot 4.7+)
`get_open_scripts`	List scripts open in editor

Editor Tools (15)

Tool	Description
`get_editor_errors`	Get errors and stack traces
`get_output_log`	Get output panel content
`get_editor_screenshot`	Capture editor viewport
`get_game_screenshot`	Capture running game
`execute_editor_script`	Run arbitrary GDScript in editor
`clear_output`	Clear output panel
`get_signals`	Get all signals of a node with connections
`reload_plugin`	Reload the MCP plugin (auto-reconnect)
`reload_project`	Rescan filesystem and reload scripts
`compare_screenshots`	Compare two screenshots
`set_auto_dismiss`	Auto-dismiss blocking editor dialogs ("Reload from disk?" etc.)
`get_editor_camera`	Get 3D editor camera position/rotation/FOV (+ snap settings on 4.6+)
`set_editor_camera`	Move the 3D editor camera to frame a view
`get_unsaved_state`	Report open scenes/scripts with unsaved changes (unsaved lists need Godot 4.7+)
`save_all`	Save all open scenes and modified script buffers, report what was saved (scripts need Godot 4.7+)

Input Tools (5)

Tool	Description
`simulate_key`	Simulate keyboard key press/release
`simulate_mouse_click`	Simulate mouse click at position
`simulate_mouse_move`	Simulate mouse movement
`simulate_action`	Simulate Godot Input Action
`simulate_sequence`	Sequence of input events with frame delays

Input Map Tools (2)

Tool	Description
`get_input_actions`	List all input actions
`set_input_action`	Create/modify input action

Runtime Tools (20)

Tool	Description
`get_game_scene_tree`	Scene tree of running game
`get_game_node_properties`	Node properties in running game
`set_game_node_property`	Set node property in running game
`execute_game_script`	Run GDScript in game context
`capture_frames`	Multi-frame screenshot capture
`record_frames`	Record many frames to PNG files on disk
`monitor_properties`	Record property values over time
`watch_signals`	Log signal emissions on nodes over a duration
`start_recording`	Start input recording
`stop_recording`	Stop input recording
`replay_recording`	Replay recorded input
`find_nodes_by_script`	Find game nodes by script
`get_autoload`	Get autoload node properties
`find_ui_elements`	Find UI elements in game
`click_button_by_text`	Click button by text content
`wait_for_node`	Wait for node to appear
`find_nearby_nodes`	Find nodes near position
`navigate_to`	Navigate to target position
`move_to`	Walk character to target
`batch_get_properties`	Batch get multiple node properties

Animation Tools (6)

Tool	Description
`list_animations`	List all animations in AnimationPlayer
`create_animation`	Create new animation
`add_animation_track`	Add track (value/position/rotation/method/bezier)
`set_animation_keyframe`	Insert keyframe into track
`get_animation_info`	Detailed animation info with all tracks/keys
`remove_animation`	Remove an animation

TileMap Tools (6)

Tool	Description
`tilemap_set_cell`	Set a single tile cell
`tilemap_fill_rect`	Fill rectangular region with tiles
`tilemap_get_cell`	Get tile data at cell
`tilemap_clear`	Clear all cells
`tilemap_get_info`	TileMapLayer info and tile set sources
`tilemap_get_used_cells`	List of used cells

Theme & UI Tools (8)

Tool	Description
`create_theme`	Create Theme resource file
`set_theme_color`	Set theme color override
`set_theme_constant`	Set theme constant override
`set_theme_font_size`	Set theme font size override
`set_theme_stylebox`	Set StyleBoxFlat override
`setup_control`	Configure Control/Container layout in one call
`add_virtual_joystick`	Add an on-screen VirtualJoystick bound to input actions (Godot 4.7+)
`get_theme_info`	Get theme overrides info

Profiling Tools (2)

Tool	Description
`get_performance_monitors`	All performance monitors (FPS, memory, physics, etc.)
`get_editor_performance`	Quick performance summary

Batch & Refactoring Tools (7)

Tool	Description
`find_nodes_by_type`	Find all nodes of a type
`find_signal_connections`	Find all signal connections in scene
`batch_set_property`	Set property on all nodes of a type
`batch_add_nodes`	Add a whole node tree in one call
`find_node_references`	Search project files for pattern
`get_scene_dependencies`	Get resource dependencies
`cross_scene_set_property`	Set property across all scenes

Shader Tools (6)

Tool	Description
`create_shader`	Create shader with template
`read_shader`	Read shader file
`edit_shader`	Edit shader (replace/search-replace)
`assign_shader_material`	Assign ShaderMaterial to node
`set_shader_param`	Set shader parameter
`get_shader_params`	Get all shader parameters

Export Tools (4)

Tool	Description
`list_export_presets`	List export presets
`export_project`	Get export command for preset
`export_patch_pck`	Export a patch PCK with only files changed since given base packs
`get_export_info`	Export-related project info

Resource Tools (4)

Tool	Description
`read_resource`	Read .tres resource properties
`edit_resource`	Edit resource properties
`create_resource`	Create new .tres resource
`get_resource_preview`	Get resource thumbnail

Physics Tools (6)

Tool	Description
`setup_collision`	Add collision shapes to nodes
`set_physics_layers`	Set collision layer/mask
`get_physics_layers`	Get collision layer/mask info
`add_raycast`	Add RayCast2D/3D node
`setup_physics_body`	Configure physics body properties
`get_collision_info`	Get collision shape details

3D Scene Tools (7)

Tool	Description
`add_mesh_instance`	Add MeshInstance3D with primitive mesh
`setup_lighting`	Add/configure light nodes
`set_material_3d`	Set StandardMaterial3D properties
`setup_environment`	Configure WorldEnvironment
`setup_camera_3d`	Configure Camera3D properties
`add_gridmap`	Set up GridMap node
`get_gridmap_info`	Inspect a GridMap: MeshLibrary, bounds, per-item counts, filtered cells (octant summary on 4.7+)

Particle Tools (5)

Tool	Description
`create_particles`	Create GPUParticles2D/3D
`set_particle_material`	Configure ParticleProcessMaterial
`set_particle_color_gradient`	Set color gradient for particles
`apply_particle_preset`	Apply preset (fire, smoke, sparks, etc.)
`get_particle_info`	Get particle system details

Navigation Tools (5)

Tool	Description
`setup_navigation_region`	Configure NavigationRegion
`bake_navigation_mesh`	Bake navigation mesh
`setup_navigation_agent`	Configure NavigationAgent
`set_navigation_layers`	Set navigation layers
`get_navigation_info`	Get navigation setup info

Audio Tools (6)

Tool	Description
`get_audio_bus_layout`	Get audio bus layout info
`add_audio_bus`	Add audio bus
`set_audio_bus`	Configure audio bus properties
`add_audio_bus_effect`	Add effect to audio bus
`add_audio_player`	Add AudioStreamPlayer node
`get_audio_info`	Get audio-related node info

AnimationTree Tools (9)

Tool	Description
`create_animation_tree`	Create AnimationTree
`get_animation_tree_structure`	Get tree structure
`add_state_machine_state`	Add state to state machine
`remove_state_machine_state`	Remove state from state machine
`add_state_machine_transition`	Add transition between states
`remove_state_machine_transition`	Remove state transition
`set_blend_tree_node`	Configure blend tree nodes
`set_tree_parameter`	Set AnimationTree parameter
`setup_ik_modifier`	Add and configure an IK SkeletonModifier3D (TwoBoneIK3D, CCDIK3D, FABRIK3D, ...) on a Skeleton3D (Godot 4.6+)

Analysis & Search Tools (6)

Tool	Description
`find_unused_resources`	Find unreferenced resources
`analyze_signal_flow`	Map signal connections
`analyze_scene_complexity`	Analyze scene performance
`find_script_references`	Find where script/resource is used
`detect_circular_dependencies`	Find circular scene dependencies
`get_project_statistics`	Get project-wide statistics

Testing & QA Tools (6)

Tool	Description
`run_test_scenario`	Run automated test scenario
`assert_node_state`	Assert node property values
`assert_screen_text`	Check for text on screen
`run_stress_test`	Run performance stress test
`set_game_speed`	Read/set the running game's Engine.time_scale (slow motion / fast-forward)
`get_test_report`	Get test results report

Headless Tools (3)

Tool	Description
`run_headless_scene`	Run a scene in a separate headless Godot process (e.g. a project's test suite)
`run_headless_script`	Run an `extends SceneTree` script with `godot --headless --script`
`get_godot_executable`	Path of the editor's Godot binary, project path and platform

Android Tools (3)

Tool	Description
`list_android_devices`	List Android devices visible to adb
`get_android_preset_info`	Read an Android export preset's package name/export path
`deploy_to_android`	Export APK, install via adb and launch (like Remote Deploy)

Key Features

UndoRedo Integration: All node/property operations support Ctrl+Z
Smart Type Parsing: "Vector2(100, 200)", "#ff0000", "Color(1,0,0)" auto-converted
Auto-Reconnect: Exponential backoff reconnection (1s → 2s → 4s ... → 60s max)
Heartbeat: 10s ping/pong keeps connection alive
Helpful Errors: Error responses include suggestions for next steps

Competitive Comparison

Tool Count

Category	Godot MCP Pro	GDAI MCP ($19)	tomyud1 (free)	Dokujaa (free)	Coding-Solo (free)	ee0pdt (free)	bradypp (free)
Project	10	5	4	0	2	2	2
Scene	10	8	11	9	3	4	5
Node	17	8	0	8	2	3	0
Script	9	5	6	4	0	5	0
Editor	15	5	1	5	1	3	2
Input	7	2	0	0	0	0	0
Runtime	20	0	0	0	0	0	0
Animation	6	0	0	0	0	0	0
TileMap	6	0	0	0	0	0	0
Theme/UI	8	0	0	0	0	0	0
Profiling	2	0	0	0	0	0	0
Batch/Refactor	7	0	0	0	0	0	0
Shader	6	0	0	0	0	0	0
Export	4	0	0	0	0	0	0
Resource	4	0	0	0	0	0	0
Physics	6	0	0	0	0	0	0
3D Scene	7	0	0	0	0	0	0
Particle	5	0	0	0	0	0	0
Navigation	5	0	0	0	0	0	0
Audio	6	0	0	0	0	0	0
AnimationTree	9	0	0	0	0	0	0
Analysis	6	0	0	0	0	0	0
Testing/QA	6	0	0	0	0	0	0
Asset/AI	0	0	1	6	0	0	0
Material	0	0	0	2	0	0	0
Other	0	0	9	5	5	2	1
Headless	3	0	0	0	0	0	0
Android Deploy	3	0	0	0	0	0	0
Total	187	~30	32	39	13	19	10

Feature Matrix

Feature	Godot MCP Pro	GDAI MCP ($19)	tomyud1 (free)	Dokujaa (free)	Coding-Solo (free)
Connection	WebSocket (real-time)	stdio (Python)	WebSocket	TCP Socket	Headless CLI
Undo/Redo	Yes	Yes	No	No	No
JSON-RPC 2.0	Yes	Custom	Custom	Custom	N/A
Auto-reconnect	Yes (exponential backoff)	N/A	No	No	N/A
Heartbeat	Yes (10s ping/pong)	No	No	No	No
Error suggestions	Yes (contextual hints)	No	No	No	No
Screenshot capture	Yes (editor + game)	Yes	No	No	No
Game input simulation	Yes (key/mouse/action/sequence)	Yes (basic)	No	No	No
Runtime inspection	Yes (scene tree + properties + monitor)	No	No	No	No
Signal management	Yes (connect/disconnect/inspect)	No	No	No	No
Browser visualizer	No	No	Yes	No	No
AI 3D mesh generation	No	No	No	Yes (Meshy API)	No

Exclusive Categories (No Competitor Has These)

Category	Tools	Why It Matters
Animation	6 tools	Create animations, add tracks, set keyframes — all programmatically
TileMap	6 tools	Set cells, fill rects, query tile data — essential for 2D level design
Theme/UI	8 tools	StyleBox, colors, fonts — build UI themes without manual editor work
Profiling	2 tools	FPS, memory, draw calls, physics — performance monitoring
Batch/Refactor	7 tools	Find by type, batch property changes, cross-scene updates, dependency analysis
Shader	6 tools	Create/edit shaders, assign materials, set parameters
Export	4 tools	List presets, get export commands, check templates
Physics	6 tools	Set up collision shapes, bodies, raycasts, and layer management
3D Scene	7 tools	Add meshes, cameras, lights, environment, GridMap support
Particle	5 tools	Create particles with custom materials, presets, and gradients
Navigation	5 tools	Configure navigation regions, agents, pathfinding, baking
Audio	6 tools	Complete audio bus system, effects, players, live management
AnimationTree	9 tools	State machines, transitions, blend trees and IK modifiers
Testing/QA	6 tools	Automated testing, assertions, stress testing, screenshot comparison
Runtime	20 tools	Inspect and control game at runtime: inspect, record, replay, navigate

Architecture Advantages

Aspect	Godot MCP Pro	Typical Competitor
Protocol	JSON-RPC 2.0 (standard, extensible)	Custom JSON or CLI-based
Connection	Persistent WebSocket with heartbeat	Per-command subprocess or raw TCP
Reliability	Auto-reconnect with exponential backoff (1s→60s)	Manual reconnection required
Type Safety	Smart type parsing (Vector2, Color, Rect2, hex colors)	String-only or limited types
Error Handling	Structured errors with codes + suggestions	Generic error messages
Undo Support	All mutations go through UndoRedo system	Direct modifications (no undo)
Port Management	Auto-scan ports 6505-6509	Fixed port, conflicts possible

License

Proprietary — see LICENSE for details. Purchase includes lifetime updates.