A basic remote MCP server with arithmetic and utility tools
This server has 2 tools with critical gaps in parameter documentation. Both tools lack parameter descriptions entirely, violating the core pattern that 100% of A+ tools have documented parameters. Tool descriptions are minimal (10-14 chars) and fall well below the 34-char p10 baseline. Input schemas are present with types but parameters have null descriptions, making it impossible for LLMs to understand what each parameter controls. The resource (echo_resource) is functional but not a tool per the MCP spec. Overall definition quality is Poor (D grade territory).
Add two numbers.
Generate a random number in the given range [min_val, max_val].
Missing parameter descriptions on all tools. Both 'add' and 'random_number' have input schema with types but description field is null for every parameter. LLMs cannot infer what 'a' vs 'b' mean or what 'min_val' vs 'max_val' control without explicit descriptions.
Tool descriptions are too brief (10-14 chars). 'Add two numbers.' and 'Generate a random number in the given range [min_val, max_val].' are below the 34-char p10 baseline. Descriptions lack context for when to use the tool instead of alternatives, prerequisites, or return type documentation.
Parameter schema lacks clarity on constraints and format. 'add' accepts floats but provides no min/max bounds or precision guidance. 'random_number' accepts ints but does not document the expected range relationship (min_val <= max_val) or what happens if violated.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 40 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |
No output schema documentation. Neither tool documents its return type or structure explicitly. LLMs cannot plan downstream operations or validate expected results.
No error handling or recovery guidance. If 'random_number' is called with min_val > max_val, no documented error type or corrective action is provided. LLMs receive no recovery path.