MCP server demonstrating Server-Sent Events (SSE) streaming capabilities with FastMCP
Single tool 'add' has a clear verb-noun name and basic description, but critical gaps undermine quality. The description is only 34 characters (below the 50-char minimum for clarity) and lacks context on when/why to use it. Input schema is present with proper types (integer) and descriptions for both parameters, meeting baseline requirements. However, the tool returns a StreamingResponse object without documenting the output schema, LLMs cannot predict what fields or structure to expect. No error handling guidance, no parameter constraints (min/max for integers), and no indication of idempotency or side effects. The tool appears to perform a trivial computation but streams it unnecessarily, raising questions about real-world applicability. Overall, this reads as a demo/proof-of-concept rather than a production-ready tool.
Stream addition process using SSE
Output schema not documented. Tool returns StreamingResponse but LLM cannot predict structure of streamed events or final result format.
Description too brief (34 chars). Does not explain WHAT the tool does, WHEN to use it, or WHAT it returns. Minimum 50 chars recommended; 194 chars is baseline for A+ tools.
No parameter constraints. Integer parameters 'a' and 'b' lack min/max bounds, allowing LLM to pass absurd values (e.g., 999999999) without guidance.
No error handling or recovery guidance. Tool provides no error messages, validation, or hints for LLM on what to do if input is invalid.
Streaming implementation unclear for MCP context. Tool returns SSE StreamingResponse, but MCP protocol expects structured JSON responses. Streaming semantics not aligned with MCP spec.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |