A simple MCP server providing calculator tools without authentication
Two tools with basic schemas and minimal descriptions. Both tools have input schemas with proper types (number, string enum), but descriptions are extremely short (10-40 chars), falling well below the 50-200 char baseline for LLM-optimized descriptions. No output schema documentation. Error handling exists (divide-by-zero check) but lacks recovery guidance. Tool names are action-oriented (add, calculate) but lack verb_noun clarity, 'calculate' is generic and ambiguous about which operations it supports without reading the schema.
Simple addition tool
Calculator tool with multiple operations
Descriptions critically short (10-40 chars). 'Simple addition tool' and 'Calculator tool with multiple operations' lack context for LLM selection. Should explain WHEN to use each tool, what distinguishes them, and what they return.
No output schema documented. LLMs cannot plan downstream calls or extract structured data. Should document that both tools return a text field containing the numeric result.
Tool naming lacks clarity. 'calculate' is generic, does it support only arithmetic, or also trigonometry, logarithms? 'add' is clear, but 'calculate' invites confusion when multiple tools exist. Consider 'calculate_arithmetic' or split into domain-specific tools.
Error handling for divide-by-zero returns plain text 'Error: Cannot divide by zero' without recovery guidance. Should indicate this is a user-fixable error and suggest valid inputs.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
Parameter descriptions are minimal. 'First number to add' and 'First operand' lack format/range guidance. Should specify: are negative numbers allowed? Decimals? What is the valid range?