MCP server for the Timberborn game, providing tools to query game state, mod information, and version details
TimberbornMCP provides 3 read-only tools with clear verb-noun naming (get_*) and basic descriptions. All tools have empty input schemas (no parameters), which is appropriate for their use case. However, descriptions are minimal (34 - 50 chars, below the 50 - 200 char baseline for LLM optimization), and output schemas are not documented in the visible code. Tool annotations are present and correctly mark all three as read-only. The extensibility API (IMcpTool interface) is well-designed for third-party mods, but the core tools lack depth in documentation and output structure guidance.
Returns the currently active Unity scene (e.g. MainMenu, Game, MapEditor).
Returns every installed mod (enabled or not), in load order, with its manifest details.
Returns the running Timberborn game version.
Output schemas not documented. LLMs cannot infer what fields get_game_scene, get_modlist, or get_version return, forcing them to guess at response structure and downstream tool chaining.
Descriptions are too brief (34 - 50 chars vs. 50 - 200 char baseline). 'Returns every installed mod (enabled or not), in load order, with its manifest details' lacks context on when to call this tool vs. alternatives, and does not explain the structure of returned manifest data.
get_version description (35 chars) is minimal. Does not clarify whether it returns game version, mod API version, or both; does not explain use cases (e.g., compatibility checks).
No error handling guidance in tool descriptions. If get_modlist fails (e.g., mod directory corrupted), the LLM has no recovery path documented.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | <=2025-11-25 | v2 |
Tool annotations present but incomplete. ReadOnlyHint is set, but idempotentHint and other hints are not explicitly documented in the visible tool implementations, limiting client-side safety heuristics.