MCP server implementation demonstrating tool registration and stdio transport
The server defines a single tool 'addTwoNumbers' with a basic but incomplete definition. The tool has a short description (31 characters) and minimal parameter documentation. The input schema is visible but parameters lack sufficient context for LLM decision-making. No output schema is documented. The naming is moderately clear but lacks the action-verb convention preferred for LLM parsing. Overall, this is a tutorial-grade implementation with significant gaps in definition quality compared to production baselines.
This tool adds two numbers together
Tool description is too brief (31 chars) and lacks context for LLM selection. Does not explain WHEN to use this tool, WHAT it returns, or any prerequisites.
No output schema documented. LLMs cannot infer what fields the result contains or what type is returned (number, object, etc.), forcing them to guess.
Tool name 'addTwoNumbers' does not follow verb_noun convention (add_two_numbers). Naming inconsistency with 54-pattern baseline.
Parameter descriptions are minimal (e.g., 'First number'). Do not explain valid ranges, constraints, or how the parameter influences the result.
No error handling guidance. Does not document what happens if inputs are invalid (e.g., NaN, Infinity, very large numbers), or how the LLM should handle failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 37 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 19 | - | v1 |