A remote MCP server providing calculator tools without authentication
Two tools with minimal descriptions and basic schemas. 'add' (9 chars) and 'calculate' (10 chars) descriptions are far below the 50-200 char baseline for LLM-optimized tools. Both tools lack output schema documentation. Parameter descriptions are present but generic. No error handling guidance, no recovery paths, no idempotency hints. Tools are simple arithmetic operations with READ_ONLY risk classification, but lack the depth expected of production tools.
Simple addition tool
Calculator tool with multiple operations
Tool descriptions are critically short (9-10 chars). Current descriptions lack context on WHEN to use each tool and WHY to choose one over the other.
No output schema documented. LLMs cannot plan downstream calls or extract results without knowing what fields to expect. Both tools return text content but structure is not formally declared.
No error handling or recovery guidance. 'calculate' handles divide-by-zero with a text error message, but LLM cannot determine if error is retryable or fatal. No guidance on what to do next.
Tool naming lacks action verb clarity. 'add' and 'calculate' are generic. 'add' could be confused with 'calculate' with operation='add'. Consider 'add_numbers' and 'perform_arithmetic' for clarity.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Redundant tools. 'add' duplicates functionality of 'calculate' with operation='add'. Per composition pattern, avoid multiple tools doing the same thing. Remove 'add' or merge into 'calculate'.