Which integrations are available for this server?

Provides tools for interacting with the Godot Engine editor, enabling AI agents to manipulate nodes, tilemaps, animations, scenes, physics, and execute GDScript in a running Godot project.

How do I use Godot MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Godot MCP Create a 2D platformer scene with a player node and a tilemap using the starter tileset." 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

by bebabinlarsson-blip

Overview Schema Source Related Servers Discussions Admin

Local

🌟 What is Godot MCP?

Godot MCP transforms the Godot Editor into an autonomous, AI-driven game development environment. Using Anthropic's Model Context Protocol (MCP), it gives AI coding assistants (such as Google Antigravity, Claude Code, Cursor, Windsurf, VS Code, and OpenAI Codex) direct, native, structured control over your running Godot project.

With Godot MCP, your AI assistant doesn't just suggest code snippets—it can:

🗺️ Paint, rotate, flip, and manipulate TileMaps on the fly.
🎬 Create animations, insert keyframes, and generate dynamic presets (spins, bounces, fades, slides).
📐 Transform nodes (rotate, scale, translate) in 2D and 3D with full Undo/Redo support.
⚡ Execute arbitrary live GDScript (godot_eval) with instant return values.
🖱️ Operate editor docks, inspectors, and menus through semantic UI automation.
🎮 Build complete game scenes, configure physics, attach scripts, and manage audio buses.

Related MCP server: Godot MCP

⚡ Key Highlights

🎮 1,776 Canonical Engine Operations: Complete coverage spanning 2D/3D physics, rendering, shaders, materials, skeletal animations, particles, audio buses, tilemaps, gridmaps, CSG modeling, navigation meshes, UI controls, project settings, scene composition, Trail3D, texture streaming, and dynamic ClassDB discovery.
🧠 Adaptive Tool Exposure Engine: Seamlessly overcomes LLM context bloat and hard tool caps (such as Antigravity's 100-tool limit) using 5 distinct exposure strategies:
- AUTO: Automatically detects connected client capabilities and selects optimal density.
- FULL: Exposes all 1,776 granular tools for agents supporting unbounded tool catalogs.
- DOMAIN: Groups operations into 61 high-level domain rollups (fits comfortably within 100-tool limits).
- LAZY: Provides 33 core operational tools and discovers remaining tools on demand.
- ROUTER: Minimal 4-tool interface (omni_execute, omni_search, omni_describe, omni_stats) with sub-millisecond p50 dispatch.
⚡ Arbitrary GDScript Omnipotence (godot_eval / omni_eval): Execute ephemeral @tool GDScript directly inside the running Godot editor with full access to EditorInterface, ProjectSettings, singletons, and ClassDB without leaving residual files.
🔍 Universal Object Reflection (obj://session/id): Stateful handle management with generational safety counters, cycle detection, and bidirectional serialization across all 38+ Godot Variant types.
🖱 Semantic UI Automation: Autonomous editor control tree inspection, widget traversal, button clicking, text input, and keyboard shortcut dispatch.
🔄 Broad Version Compatibility: Zero-regression support from Godot 4.1 through Godot 4.8+ (including active Godot 4.8 development snapshots).
🤖 12 Supported AI Clients: One-command automatic configuration for Antigravity, Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Cline, Roo Code, OpenAI Codex, OpenCode, Zed, and Gemini CLI.

🚀 Quick Start

1. Requirements

Godot Engine: 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, or 4.8+ (including 4.8 dev snapshots)
Python: 3.11 – 3.14
Astral uv (recommended) or pip

2. Install the Godot Plugin

Option A: From Godot Asset Library (Recommended)

Open your Godot project.
Click the AssetLib tab at the top of the editor.
Search for Godot Omni (or Godot MCP) and click Download → Install.

Option B: Manual Installation

Copy the addons/godot_omni and addons/godot_ai directories from this repository into your Godot project's res://addons/ directory:

your-godot-project/
└── addons/
    ├── godot_omni/
    │   ├── plugin.cfg
    │   ├── plugin.gd
    │   ├── omni_dock.gd
    │   ├── omni_reflection.gd
    │   └── omni_ui_tree.gd
    └── godot_ai/
        ├── plugin.cfg
        ├── plugin.gd
        └── handlers/
            └── omni_handler.gd

Option C: Enable the Plugin

In Godot, navigate to: Project → Project Settings → Plugins and enable Godot Omni (or Godot AI).

The plugin will start the loopback WebSocket server and open the Godot AI / Omni dock in the bottom editor panel.

3. Install the Python MCP Server

# Clone the repository
git clone https://github.com/bebabinlarsson-blip/Godot-MCP.git
cd "Godot-MCP"

# Install with dev dependencies using uv
uv sync --extra dev

# Or install via pip
pip install -e .

Verify your installation:

godot-omni self-test
godot-omni tools stats

4. Connect Your AI Client

You can automatically configure your AI client with a single CLI command:

# Configure all detected clients on your system
godot-omni clients configure all

# Or configure a specific client:
godot-omni clients configure antigravity
godot-omni clients configure claude-code
godot-omni clients configure claude-desktop
godot-omni clients configure cursor
godot-omni clients configure windsurf
godot-omni clients configure vscode

Manual Client Configuration (JSON)

If you prefer manual configuration, add the following to your client's MCP configuration file (e.g., claude_desktop_config.json, .cursor/mcp.json, or Antigravity MCP settings):

{
  "mcpServers": {
    "godot-omni": {
      "command": "godot-omni",
      "args": ["attach"]
    }
  }
}

🤖 How the AI Uses It: Tool Capabilities & Examples

Godot MCP provides high-level and granular tools designed specifically for AI agent reasoning:

1. 🗺️ TileMap Manipulation & Rotation

The AI can paint, rotate, flip, and clear tiles dynamically:

// Place a tile with 90° clockwise rotation and horizontal flip:
call("godot-ai", "tilemap_manage", {
  "op": "tilemap_place_tile",
  "path": "/Main/World/TileMapLayer",
  "source_id": 0,
  "atlas_col": 3,
  "atlas_row": 1,
  "map_x": 12,
  "map_y": 8,
  "rotation_degrees": 90,
  "flip_h": true
})

// Rotate an existing tile by 180 degrees:
call("godot-ai", "tilemap_manage", {
  "op": "tilemap_rotate_cell",
  "path": "/Main/World/TileMapLayer",
  "map_x": 12,
  "map_y": 8,
  "degrees": 180
})

2. 🎬 Animation Clips, Tracks & Motion Presets

The AI can build complex animations from scratch or use one-call presets:

// One-call 360° smooth spin preset:
call("godot-ai", "animation_manage", {
  "op": "preset_spin",
  "player_path": "/Main/Player/AnimationPlayer",
  "target_path": "Sprite2D",
  "duration": 0.8,
  "loop": true
})

// One-call jump / bounce preset:
call("godot-ai", "animation_manage", {
  "op": "preset_bounce",
  "player_path": "/Main/Player/AnimationPlayer",
  "target_path": "Sprite2D",
  "height": 45.0,
  "duration": 0.5
})

3. 📐 Node Spatial Transformations

Direct, undoable rotation, scaling, and translation for 2D, 3D, and Control nodes:

// Rotate node:
call("godot-ai", "node_manage", {
  "op": "rotate",
  "path": "/Main/Enemy",
  "degrees": 45.0,
  "relative": true
})

// Scale node:
call("godot-ai", "node_manage", {
  "op": "scale",
  "path": "/Main/Enemy",
  "scale": [1.5, 1.5],
  "relative": false
})

4. ⚡ Live GDScript Evaluation (`godot_eval`)

When an agent needs custom logic or complex editor manipulation, it executes ephemeral GDScript in memory:

# The AI sends GDScript to run inside the editor:
func run():
    var editor = EditorInterface
    var scene = editor.get_edited_scene_root()
    print("Found scene root: ", scene.name)
    return {"status": "ok", "children_count": scene.get_child_count()}

🏛 System Architecture

┌─────────────────────────────────────────────────────────────┐
│                       AI Client                             │
│     (Antigravity / Claude Code / Cursor / Windsurf / ...)   │
└──────────────────────────────┬──────────────────────────────┘
                               │  stdio (FastMCP Protocol)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│                 Godot MCP Python Server                     │
│  ┌───────────────────────────────────────────────────────┐  │
│  │   Adaptive Exposure Engine (AUTO/FULL/DOMAIN/LAZY)    │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   Canonical Registry: 1,763 Operations / 58 Domains   │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   Universal Reflection Handle Manager (obj://...)     │  │
│  └───────────────────────────┬───────────────────────────┘  │
└──────────────────────────────┼──────────────────────────────┘
                               │  Loopback WebSocket (Port 9500)
                               │  (Rotating Token Authentication)
                               ▼
┌─────────────────────────────────────────────────────────────┐
│               Godot Editor Plugin (addons/)                 │
│  ┌───────────────────────────────────────────────────────┐  │
│  │   omni_handler.gd (WebSocket In-Editor Dispatch)      │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   godot_eval (Ephemeral @tool GDScript Execution)     │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   omni_reflection.gd (Variant ↔ JSON Serialization)   │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   omni_ui_tree.gd (Semantic Control Automation)       │  │
│  ├───────────────────────────────────────────────────────┤  │
│  │   Godot Engine APIs: ClassDB, EditorInterface, Nodes  │  │
│  └───────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

🛠 Unified CLI Reference

Godot MCP includes a powerful unified CLI (godot-omni or godot-mcp):

# 1. Tools & Registry
godot-omni tools stats                       # Summary of 1,763 operations across 58 domains
godot-omni tools search "camera"             # Search operations across all domains
godot-omni tools describe node_create        # Detailed schema, parameters, and Godot class
godot-omni tools list --domain physics_3d    # List all tools in a specific domain
godot-omni tools export schema.json          # Export complete JSON catalog

# 2. Client Management
godot-omni clients detect                    # Detect installed AI clients on host
godot-omni clients status                    # Check MCP registration status across 12 clients
godot-omni clients configure <name>          # Auto-configure specific client
godot-omni clients configure all             # Auto-configure all detected clients
godot-omni clients doctor                    # Validate client configs and report syntax errors

# 3. Performance & Benchmarks
godot-omni benchmark all                     # Run end-to-end performance benchmarks
godot-omni benchmark tools                   # Measure tool lookup & execution latency
godot-omni benchmark memory                  # Monitor memory consumption and handle footprint

# 4. Diagnostics & Health
godot-omni doctor                            # Full diagnostics: Python, Godot, network, registry
godot-omni self-test                         # 8-point in-process integration test
godot-omni versions status                   # Godot 4.1 – 4.8+ compatibility breakdown

📊 Operations Breakdown

Godot MCP classifies its 1,763 operations into 5 architectural layers:

Layer	Operations	Description
Curated Core	262	High-level operations for nodes, scenes, scripts, resources, project settings, files.
ClassDB Generated	1,370	Automatically generated wrappers for Godot engine classes and methods.
UI Automation	54	Full traversal, widget inspection, click, input, and shortcut dispatch for the editor GUI.
Runtime Execution	66	Play-in-editor monitoring, game process lifecycle, runtime capture, test suites.
Universal Reflection	11	Handle resolution, property read/write, method invocation, and variant serialization.
Total	1,763	58 unique engine domains

For full breakdown and domain catalog, see reports/tool-coverage.md.

🔒 Security & Privacy

Local Loopback Isolation: All network communication occurs strictly over 127.0.0.1 on local loopback sockets. External network access is never opened.
Rotating Cryptographic Capabilities: WebSocket communication between the Python MCP server and the Godot editor uses per-session cryptographic tokens stored with strict 0700 user permissions.
Ephemeral GDScript Execution: Dynamic code evaluated via godot_eval runs in memory as transient @tool scripts and leaves no untracked residual files.
Zero Telemetry Exfiltration: Code, scene hierarchies, script contents, and file paths are never transmitted. Telemetry can be completely disabled with GODOT_AI_DISABLE_TELEMETRY=true.

See SECURITY.md for vulnerability reporting guidelines.

👤 Author & Maintainer

Created and maintained by bebabin.

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for development environment setup, test guidelines, and PR procedures.

📄 License

This project is licensed under the MIT License.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

OmniDebugLink AOAuth
dev.omnidebuglink.api
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
Coding Agents Developer Tools
61
ChiR24-unreal_mcp_serverOAuth
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Developer Tools App Automation Software Architecture
2875
mcp-serverOAuth
com.make
Give your AI agents the tools to build, manage, and run automation workflows.
App Automation Developer Tools Workplace & Productivity
2
sncro A
io.github.scottconfusedgorilla
Live browser debugging for AI assistants — DOM, console, network via MCP.
Browser Automation Developer Tools Monitoring
2

Related MCP Servers

Godot MCP Toolkit
Developer Tools Testing & QA Tools
woyucbugongdaitian
A
license
B
quality
B
maintenance
Enables AI assistants to automate Godot 4 projects via headless tooling, live editor control, and runtime remote control, including scene building, testing, and observation.
Updated a month ago (2026-08-18 09:30 UTC)
43
1
MIT
Godot MCP
Developer Tools Games & Gamification Software Architecture
tomyud1
A
license
Not graded
quality
A
maintenance
Enables AI assistants to fully access and manipulate Godot editor projects, including scenes, scripts, nodes, and settings, with an interactive visualizer.
Updated a month ago (2026-08-24 06:08 UTC)
427
MIT
Godot MCP
Games & Gamification Developer Tools Testing & QA Tools
mcintalmo
A
license
C
quality
B
maintenance
Enables AI assistants to interact with the Godot Engine editor and projects, including scene editing, script management, physics queries, and asset operations.
Updated a month ago (2026-08-23 18:30 UTC)
126
1
MIT
Godot MCP Flash
Developer Tools Games & Gamification Code Analysis
gurolayanlar
A
license
B
quality
C
maintenance
Enables AI agents to inspect, modify, run, and debug Godot projects, including scene and script analysis, editor and project management, and visual verification through screenshots.
Updated 14 days ago (2026-09-05 11:54 UTC)
22
158 npm
7
MIT

🌟 What is Godot MCP?

⚡ Key Highlights

🚀 Quick Start

1. Requirements

2. Install the Godot Plugin

Option A: From Godot Asset Library (Recommended)

Option B: Manual Installation

Option C: Enable the Plugin

3. Install the Python MCP Server

4. Connect Your AI Client

Manual Client Configuration (JSON)

🤖 How the AI Uses It: Tool Capabilities & Examples

1. 🗺️ TileMap Manipulation & Rotation

2. 🎬 Animation Clips, Tracks & Motion Presets

3. 📐 Node Spatial Transformations

4. ⚡ Live GDScript Evaluation (godot_eval)

🏛 System Architecture

🛠 Unified CLI Reference

📊 Operations Breakdown

🔒 Security & Privacy

👤 Author & Maintainer

🤝 Contributing

📄 License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Godot MCP Toolkit

Godot MCP

Godot MCP

Godot MCP Flash

4. ⚡ Live GDScript Evaluation (`godot_eval`)