A remote MCP server with OAuth 2.0 authentication provider, demonstrating authorization flows and MCP tool registration on Cloudflare Workers
Single tool 'add' has a clear verb-noun name and basic schema with typed parameters. However, the description is extremely minimal (23 chars), barely meeting the 10-char floor. Parameter descriptions are present but terse (18-19 chars each). No output schema is documented, the response structure is inferred from code only. No error handling guidance, no idempotency hints, no composition context. The tool is trivial (arithmetic), so complexity is low, but the definition lacks the rigor expected for production use. Baseline: 194 chars avg description, 72 chars avg param annotation. This server falls well below those standards.
Adds two numbers together
Tool description is 23 characters, below the 50-char minimum for LLM clarity. 'Adds two numbers together' lacks context on when to use it, what it returns, or any prerequisites.
Output schema is not documented. Code shows response is {content: [{type: 'text', text: string}]}, but this structure is invisible to LLMs reading the tool definition. LLMs cannot plan downstream calls without knowing the response shape.
Parameter descriptions are 18 - 19 characters each ('First number to add', 'Second number to add'). Baseline is 72 chars. These lack format hints, range constraints, or examples. No guidance on what happens if inputs are NaN, Infinity, or very large numbers.
No error handling documented. What if inputs are non-numeric? What if the sum overflows? No recovery guidance for the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
Tool is marked READ_ONLY but has no idempotency or composition context. No indication of whether it can be safely retried or chained with other tools.