An educational tool that visualizes Model Context Protocol (MCP) communication between an LLM-powered chat interface and MCP servers, designed to teach users how MCP orchestrates tool calling through transparent, real-time message flow visualization.
Three tools with basic definitions and schemas, but significant gaps in parameter descriptions and error handling guidance. Tool names follow verb_noun convention (search, read, recommend) and are action-oriented. Schemas are present and properly typed. However, parameter descriptions are minimal (1-2 sentences) and lack actionable guidance on format, constraints, or dependencies. Output schemas are not documented. Error handling provides no recovery guidance. The server is functional but falls short of production-grade quality expected in A/B range.
Read specific AWS documentation page
Get related documentation recommendations
Search AWS documentation by phrase
Parameter descriptions are minimal and lack actionable guidance on format, constraints, or valid values. E.g., 'limit' is described as 'Maximum number of results to return (optional)' but provides no bounds (1-100? 1-1000?) or rationale for why pagination matters.
Output schemas are not documented. Callers cannot infer the structure of results (are they paginated? do they include URLs, summaries, metadata?). This forces agents to guess or make failed attempts.
Tool descriptions do not explain when to use each tool or how they differ. Users (or LLMs) cannot easily distinguish between 'search_documentation' (find docs by keyword) vs 'recommend' (find related docs for a given URL). Are these used sequentially? Independently?
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 66 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 38 | - | v1 |
No error handling guidance. If a search returns no results, if a URL is invalid, or if the AWS documentation service is down, the tool provides no recovery hints. LLMs have no fallback strategy.
'limit' parameter in search_documentation lacks bounds. Unbounded numbers let LLMs pass absurd values (1 million results?) that could break pagination or timeout the API.
Tool 'recommend' has a vague name. Does it recommend documentation related to a topic, or recommend tools/services? The description clarifies it's URL-based, but 'recommend' alone is generic and could confuse agents choosing between multiple recommendation tools.