Enhanced Model Context Protocol server for Godot Engine with advanced features for Windsurf AI
Server has 7 tools with basic schemas and descriptions, but significant gaps limit production readiness. All tools are READ_ONLY and lack error handling guidance. Descriptions are present but generic (avg ~80 chars, below 194-char baseline). Most parameters lack descriptions entirely. No output schemas documented. No tool annotations (readOnlyHint, etc.). Parameter validation rules not stated. Tool composition is reasonable (single responsibility), but descriptions don't explain WHEN to use each tool or dependencies between them.
Get a recursive tree view of all files and directories in the project
Get information about the Godot project including name, version, and settings
Get the raw content of the current scene file
Get a recursive tree view of all nodes in the current scene with properties
Convert a project path (res://) to a Godot UID
Search for files in the project using fuzzy matching
Convert a Godot UID (uid://) to a project path (res://)
Parameter descriptions missing or incomplete. 'filters' in get_filesystem_tree has a description, but most other parameters lack any guidance. LLMs cannot infer what 'query' means in search_files without explicit description of expected format, length, or matching behavior.
No output schemas documented. Tool descriptions state what they return (e.g., 'tree view', 'content') but do not specify field names, types, or structure. LLMs cannot plan downstream calls or extract data reliably without knowing response shape.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
No error handling guidance. Tools call external Godot API (call_godot_api) which can fail with HTTP errors or timeouts, but no tool description explains what errors are possible, whether they are retryable, or what the LLM should do next. Error responses return generic {'success': False, 'error': '...'} without recovery hints.
No tool annotations. Tools lack readOnlyHint, destructiveHint, or idempotentHint metadata. All 7 tools are READ_ONLY, but this is not declared in the tool definition, only inferred from the Risk field in the spec. MCP spec 2026-07-28 expects tool annotations in the Tool object.
Descriptions lack WHEN-to-use guidance. 'Get a recursive tree view of all files' does not explain when to call get_filesystem_tree vs search_files, or what the filters parameter does. LLMs cannot disambiguate between similar tools without explicit guidance.