MCP server for the Merlin TMS1100 emulator, providing AI control over a browser-based Parker Brothers Merlin (1978) game console emulator via HTTP JSON-RPC transport
merlin-mcp defines 4 tools with basic descriptions and input schemas. Naming follows verb_noun convention (press_button, release_button, reset, get_leds). However, parameter descriptions are minimal (e.g., 'Button name: pad0-pad10...' lacks context on when/why to use each button). Tool descriptions are short (10-50 chars) and lack guidance on prerequisites, side effects, or multi-step workflows. No output schemas documented. Error handling is absent, no recovery guidance if browser disconnects or invalid button is pressed. The stateless broker architecture is sound, but tool definitions lack LLM-optimization patterns.
Get the current state of all 11 LED pads (0=off, 1=on)
Press and hold a Merlin button (pad or game control button)
Release a previously pressed Merlin button
Reset the Merlin emulator to power-on state
No output schemas documented. LLMs cannot infer what get_leds returns (array of ints? object with field names? count?). Downstream tool chaining is impossible without guessing.
Parameter descriptions are minimal and lack context. 'Button name: pad0-pad10...' does not explain WHEN to press vs release, or what happens if an invalid button is pressed. LLMs cannot reason about button semantics.
Tool descriptions are too short (10-50 chars). 'Press and hold a Merlin button' lacks context on game state, timing, or side effects. Descriptions should be 50-200 chars with WHAT/WHEN/WHY guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No error handling or recovery guidance. If browser disconnects, LLM receives 'no browser connected' but has no guidance on what to do next. Should suggest 'Open the Merlin page in a browser and retry.'
Button parameter accepts free-form strings with no enum constraint. LLMs may hallucinate invalid button names like 'pad11' or 'start'. Should declare enum: ['pad0', 'pad1', ..., 'pad10', 'newgame', 'samegame', 'hitme', 'compturn'].