A simple MCP server providing calculator tools with basic arithmetic operations
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 schemas documented. Error handling is minimal (divide-by-zero check in 'calculate' returns plain text, not structured error). Tool names lack action verbs ('add' and 'calculate' are weak; 'perform_addition' and 'perform_calculation' would be clearer). No parameter descriptions beyond type hints. No guidance on when to use one tool vs. the other.
Simple addition tool
Calculator tool with multiple operations
Descriptions are critically short (10-40 chars). 'Simple addition tool' and 'Calculator tool with multiple operations' lack context for LLM selection. Should explain WHAT the tool does, WHEN to use it, and what it returns (e.g., 'Adds two numbers and returns the sum as a text response. Use for basic arithmetic when only addition is needed.').
No parameter descriptions. Parameters 'a', 'b', and 'operation' lack explanations. LLMs cannot infer that 'a' and 'b' are operands or that 'operation' must be one of the enum values. Add descriptions like 'First operand (number)' and 'Arithmetic operation: add, subtract, multiply, or divide'.
No output schema documented. Callers do not know the response structure. Document that both tools return {content: [{type: 'text', text: string}]} or provide a clearer response format.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Tool naming lacks action verbs. 'add' and 'calculate' are generic. Prefer 'perform_addition', 'perform_arithmetic', or 'compute_result' to clarify intent. Current names do not follow verb_noun convention.
Error handling is minimal and unstructured. Divide-by-zero returns plain text 'Error: Cannot divide by zero' instead of a structured error with recovery guidance. Should return {error: 'division_by_zero', message: 'Cannot divide by zero. Ensure the divisor is non-zero.'}.