A remote MCP server providing calculator tools without authentication, deployed on Cloudflare Workers
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 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. Schemas are visible and properly typed, preventing a lower score, but the overall quality is below median for production tools.
Simple addition tool
Calculator tool with multiple operations
Tool 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 their sum as a numeric result. Use when you need basic arithmetic addition.').
Parameter descriptions are missing entirely. Schema shows types (a: number, b: number, operation: enum) but no descriptions explaining what each parameter controls or its valid range. LLMs cannot infer that 'a' and 'b' are operands without explicit text.
Output schema is not documented. Tools return {content: [{type: 'text', text: String}]} but this structure is not declared in tool metadata. LLMs cannot plan downstream calls or extract structured data without knowing the response format.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Tool names lack action verbs. 'add' and 'calculate' are generic. Better names: 'perform_addition', 'perform_arithmetic', or 'compute_operation'. Verb-noun naming helps LLMs parse intent from the name alone.
Error handling is minimal and unstructured. 'calculate' returns plain text 'Error: Cannot divide by zero' instead of a structured error response with recovery guidance. Should return {error: {code: 'DIVISION_BY_ZERO', message: '...', recovery: 'Use a non-zero divisor'}}.