godot-devtool

Godot Devtool MCP Router

Compatibility: godot-devtool 3.2.1.

Tool catalog: tools/list is intentionally context-budget-safe and router-only. It exposes only get_capabilities, get_godot_version, and list_projects, plus _meta.toolCategories summaries for route groups, workflows, transports, and risk levels; it has no cursor pagination and no environment-variable fallback to full schemas. All 235 tools and full input schemas are discoverable through filtered get_capabilities. The default get_capabilities response is a lightweight index without input schemas. Request schemas only for the active workflow, routeGroup, exact toolNames, or another narrow filter with includeSchemas: true. Unfiltered schema requests are rejected.

Use this entry skill first. Then keep only the matching domain skill in context:

• godot-devtool-project-setup: install or upgrade the addon, inspect projects, configure InputMap/autoload/export settings.
• godot-devtool-live-editor: use the open Godot editor through editor_ws, including selection, Inspector, UndoRedo edits, Dock status, and editor_save_scene.
• godot-devtool-runtime-test: run the game, prove runtime bridge state through runtime_ws, simulate input, inspect node properties, and stop runs.
• godot-devtool-scene-authoring: author scenes/resources/scripts with native and headless Godot tools such as add_node, get_node_properties, and update_node_properties.
• godot-devtool-release-verify: validate this MCP package, docs, build output, and local Skill sync before release.

Client Setup

Typical local release-zip MCP client configuration:

{
  "mcpServers": {
    "godot-devtool": {
      "command": "node",
      "args": ["E:/godot-devtool/build/index.js"],
      "env": {
        "GODOT_PATH": "D:/Program Files/Godot/Godot_v4.x.exe",
        "GODOT_DEVTOOL_WS_PORT": "8766"
      }
    }
  }
}

Codex Desktop uses TOML in config.toml:

[mcp_servers.godot-devtool]
command = "node"
args = ["E:/godot-devtool/build/index.js"]
env = { GODOT_PATH = "D:/Program Files/Godot/Godot_v4.x.exe", GODOT_DEVTOOL_WS_PORT = "8766" }