A simple MCP server providing calculator tools without authentication
The server defines two tools with partial quality. Both tools have schemas with Zod validation and basic descriptions, but the descriptions are minimal (10-16 chars each). The 'add' tool is trivially simple with only 2 parameters. The 'calculate' tool is slightly more complex with an enum constraint on 'operation', but lacks error handling documentation. Parameter descriptions are present but terse. No output schemas are documented. Division by zero is handled inline but the error response is unstructured text, not actionable guidance. The server uses HTTP transport via Cloudflare Workers, which is current-spec compliant.
Simple addition tool
Calculator tool with multiple operations
Tool descriptions are critically short (10-16 chars). 'Simple addition tool' and 'Calculator tool with multiple operations' lack context on WHEN to use each tool or WHAT they return.
No documented output schemas. Tools return text-wrapped results but the structure is not declared. LLMs cannot plan downstream calls or extract typed fields without knowing the response format.
Error handling is minimal and unstructured. Division by zero returns plain text 'Error: Cannot divide by zero' instead of actionable guidance. No recovery guidance provided.
Tool 'calculate' conflates two responsibilities: arithmetic (add/subtract/multiply/divide) in a single tool. Alternatively, rename to make the scope clearer.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 49 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |
Parameter descriptions are generic or minimal. 'First number', 'Second number', 'The arithmetic operation to perform' lack detail on constraints, ranges, or expected formats.
No tool annotations. Per current MCP spec (2026-07-28), tools should declare readOnlyHint/destructiveHint/idempotentHint to signal safety properties. All three tools here are read-only (stated in rubric as 'Risk: READ_ONLY') but this is not declared in the tool definitions themselves.