An interactive narrative MCP server that guides users through a branching reincarnation story with multiple paths (revenge, Bilbo Baggins, or Luffy from One Piece)
This server has severe definition quality issues. Tool names lack action verbs (handle_user_message, ask_guidance_questions are vague). Descriptions are present but generic and lack LLM-optimization guidance. Input schemas are visible but lack proper type constraints and enums. No output schemas documented. Parameters like 'answers' (array) and 'path_choice' (integer) lack detailed format/range descriptions. Error handling is absent, no recovery guidance, no validation messages. The tool 'handle_user_message' conflates routing logic with message processing, violating single-responsibility. No tool demonstrates idempotency or permission gating. Composition is poor: tools should be split (e.g., start_story + ask_guidance_questions could be one discovery flow). No pagination, no batch operations, no chaining IDs in responses.
Present the three guidance questions to the user
Generate the introduction narrative when a path is chosen
Retrieve the current story state for a user
Main entry point - handle any user message and route accordingly
Process user input during active story progression and generate narrative continuation
Record user's answers and choose their reincarnation path
Reset a user's story state to start over
Tool names lack action verbs and are vague. 'handle_user_message' and 'ask_guidance_questions' do not clearly signal intent. Should be 'route_user_message', 'present_guidance_questions', 'generate_story_continuation'.
No output schemas documented. LLMs cannot infer what fields are returned or plan downstream calls. Every tool must document its return type structure.
Parameter descriptions lack format/range constraints. 'answers' is an array but no item type or length limit specified. 'path_choice' is integer but valid range (1-3) not documented. 'user_input' is free-form string with no length or content constraints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Alternative way to start the story programmatically
No error handling or recovery guidance. Tools do not return actionable error messages. If user_id is invalid or story state is corrupted, no guidance on what to do next.
Tool 'record_answers_and_choose_path' combines two responsibilities: recording answers AND choosing path. Should split into 'record_guidance_answers' + 'choose_reincarnation_path' for composability.