A remote MCP server providing calculator tools with addition and multi-operation arithmetic capabilities
Two tools with basic schemas and minimal descriptions. Both tools have input schemas with proper types (number, enum), but descriptions are extremely short (10-40 chars) and lack context for LLM selection. No output schema documentation. Error handling present in 'calculate' (divide-by-zero) but not generalized. Tool names lack action verbs ('add', 'calculate' are weak; 'perform_addition', 'execute_calculation' would be clearer). Parameters have types but descriptions are terse. No guidance on when to use one tool vs. the other.
Simple addition tool
Calculator tool with multiple operations
Tool descriptions are too 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 it returns, and any prerequisites.
Tool names lack action verbs. 'add' and 'calculate' are generic. Baseline production tools start with verbs like 'get_', 'create_', 'search_'. Consider 'perform_addition' or 'execute_arithmetic_operation' for clarity.
No output schema documented. LLMs cannot plan downstream calls or extract structured data. Document what fields are returned (e.g., 'result: number, operation: string').
Parameter descriptions are minimal. 'First number to add' and 'First operand' lack format/range guidance. Should specify: numeric range, precision, whether negative/decimal allowed.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Redundant tools. 'add' duplicates the 'add' operation in 'calculate'. This forces LLMs to reason about which to call, wasting tokens. Consolidate or clearly document when to use each.