A human-in-the-loop MCP server that allows AI agents to ask humans for input, recommendations, or guidance via a web UI
Single tool 'ask_rishvan' has a clear verb-noun name and adequate description (89 chars), but critical gaps undermine quality. Input schema is visible with two required parameters (question, app_name), both typed as strings with descriptions. However, no output schema is documented, the tool's response structure is completely opaque to LLMs. The tool lacks error handling guidance, recovery instructions, and does not declare whether it is idempotent or has side effects. Risk classification is READ_ONLY but the tool actually creates persistent requests in a database (side effect not reflected). No parameter constraints (enums, ranges, formats) are specified. The description does not explain when to use this tool vs alternatives, what happens on timeout, or how the LLM should interpret the response.
Ask a human for input, recommendation, or guidance. Opens a web UI for the human to respond.
No output schema documented. LLMs cannot plan downstream actions or extract response fields. Tool returns request ID and status but this is invisible to the agent.
Risk classification 'READ_ONLY' is incorrect. Tool creates persistent database records (side effect). Must declare as 'WRITE' and include idempotency/confirmation guidance.
No error handling or recovery guidance. Tool can timeout waiting for human response, fail if database is unavailable, or reject invalid app_name. LLM has no guidance on what to do next.
Parameters lack constraints and format guidance. 'question' and 'app_name' are unbounded strings with no length limits, character restrictions, or examples of valid values.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Description does not explain when to use this tool, what the LLM should do with the response, or how long the human has to respond. Missing WHEN/WHY/WHAT guidance.