MCP server with OAuth 2.0 authorization provider running on Cloudflare Workers, demonstrating remote MCP authentication flows
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 (12-18 chars each). No output schema is documented, the response structure is inferred from code but not declared in tool metadata. No error handling guidance, no idempotency hints, no composition context. The tool is trivial (arithmetic) and does not reflect production patterns like pagination, structured output documentation, or recovery guidance.
Adds two numbers together
Tool description is 23 characters, below the 50-200 char baseline for LLM-optimized descriptions. Lacks context on when to use, what it returns, and any prerequisites.
Output schema is not documented in tool metadata. Response structure (content array with text type) is visible in code but not declared as a formal schema for the LLM.
Parameter descriptions are terse (12-18 chars). 'First number to add' and 'Second number to add' lack context on valid ranges, formats, or constraints.
No error handling guidance. Tool does not document what happens on invalid input (non-numeric values, overflow, null) or how the LLM should recover.
Tool is trivial and does not demonstrate production patterns: no pagination, no batch operations, no composition hints, no idempotency declaration.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |