A minimal MCP server with calculator and memory tools
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and error guidance. Calculator has a clear, concise description (89 chars) and proper schema with type constraints. Memory_store description is longer (165 chars) but lacks clarity on when to use each action; parameters lack descriptions for 'key' and 'value' fields. Neither tool documents output structure or provides recovery guidance on errors. No tool annotations (readOnlyHint/destructiveHint). Error handling returns plain text rather than structured guidance. Naming is acceptable but generic ('memory_store' lacks verb). Overall: functional but below production baseline of 194 chars avg description and 100% param coverage.
Evaluate a mathematical expression. Supports +, -, *, /, **, and parentheses.
Store and retrieve key-value pairs in session memory. Use action 'set' to store, 'get' to retrieve, 'list' to show all keys, 'delete' to remove.
memory_store parameters 'key' and 'value' lack descriptions. LLMs cannot infer that 'key' is required for set/get/delete but not list, or that 'value' is only for set action.
No output schema documented for either tool. Callers cannot predict response structure (e.g., is calculator result a number or string? Does memory_store return the stored value?). Baseline: 100% of A+ tools document return types.
Error responses are plain text strings without recovery guidance. 'Error: Expression contains disallowed characters' does not tell the LLM what to do next. Baseline: errors must guide recovery.
memory_store description does not clarify that 'set' and 'delete' are destructive operations. Agents need to know which calls have irreversible consequences.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Calculator should be marked readOnly; memory_store 'delete' should be marked destructive. Agents use these hints for safety planning.