SSyncDev

Godot MCP Runtime MCP Server

A lightweight, zero-footprint TypeScript MCP server that lets AI assistants interact with the Godot 4.x game engine: not just editing files, but

Local serverstdio

What is the Godot MCP Runtime MCP Server?

A lightweight, zero-footprint TypeScript MCP server that lets AI assistants interact with the Godot 4.x game engine: not just editing files, but playing the game.

What it actually does

  • Screenshots: — Capture the viewport — by default returns a 960x540 preview inline plus the full PNG on disk; use responseMode: 'full' for pixel-perfect or 'path_only' to skip the inline image
  • Input simulation: — Batched sequences of key presses, mouse clicks, mouse motion, UI element clicks by name or path, Godot action events, and timed waits
  • UI discovery: — Walk the live scene tree and collect every visible Control node with its position, type, text content, and disabled state
  • Live script execution: — Compile and run arbitrary GDScript with full SceneTree access while the game is running

Configuration

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Godot MCP Runtime MCP Server

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-runtime"],
      "env": {
        "GODOT_PATH": "<path-to-godot-executable>"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
GODOT_PATHFilesystem location the server is allowed to use.Optional
GODOT_MCP_DISABLE_ELICITATIONConfiguration value read at startup.Optional

Example prompts to try

  • “Use Godot MCP Runtime to Screenshots.”
  • “Use Godot MCP Runtime to Server.”
  • “Use Godot MCP Runtime to Variable.”

Frequently asked questions

A lightweight, zero-footprint TypeScript MCP server that lets AI assistants interact with the Godot 4.x game engine: not just editing files, but playing the game. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.