Godot multi-project / multi-instance manager built on the Godot-MCP-Native plugin and the gdmcp CLI — create, configure and start/stop Godot editor & headless instances in one click, with a dedicated MCP port per project.
Server has 19 tools with consistent naming (verb_noun pattern) and documented schemas. However, descriptions are generic and lack LLM-optimization guidance. Parameter descriptions exist but are minimal (avg ~40 chars vs baseline 72). Output schemas are not documented. Error handling is absent from visible code. Tool composition is reasonable but some tools combine multiple concerns (e.g., configure_project_mcp does install + enable + write in one call). No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels.
Register an existing Godot project in the manager
One-click MCP environment configuration: install plugin, enable in project, install gdmcp CLI, write mcp_settings.cfg
Create a new Godot project with automatic MCP configuration
Run debug commands on a project via gdmcp (doctor, editor_state, logs, runtime_tree)
Remove a project from the manager and stop all its running instances
Download and extract the Godot-MCP-Native plugin and gdmcp CLI toolchain
Retrieve log history for an instance
Detect MCP environment status for a project (plugin installed, gdmcp CLI present, etc.)
No output schemas documented. Tools return data but LLMs cannot predict field structure, forcing parsing guesses and downstream lookup calls.
Descriptions lack LLM-optimization guidance. Generic phrases like 'Retrieve' and 'Get' do not explain WHEN to call the tool or what makes it distinct from similar tools. Avg description ~50 chars vs baseline 194 chars.
configure_project_mcp combines three concerns (install plugin, enable in project, write config) in one tool. Should split into separate tools so agent can compose them independently.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Retrieve current settings and detected Godot installation path
Retrieve the full aggregated state including settings, toolchain status, projects, and instances
Get the current status of the Godot-MCP-Native toolchain (addon + gdmcp CLI)
Launch a Godot editor, headless, or game instance for a project
Start a game instance via the project's MCP server (run_project tool)
Change the MCP port assigned to a project
Stop a running game instance via the project's MCP server (stop_project tool)
Stop a running Godot instance
Subscribe to real-time state and log events via Server-Sent Events (SSE)
Switch a running editor/headless instance to the other mode (editor ⇄ headless)
Update global settings (godotPath, portBase, webPort, proxy, language)
No error handling guidance visible. Tools lack recovery hints (e.g., 'If project not found, call list_projects first'). No categorization of retryable vs fatal errors.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. delete_project is DESTRUCTIVE but unmarked; run_game is WRITE but unmarked.