A remote MCP server with OAuth 2.0 authentication provider for Cloudflare Workers, demonstrating authorization flows and MCP tool registration
Single tool 'add' has a clear verb-noun name and basic schema with typed parameters. However, the description is minimal (22 chars) and lacks context about when/why to use it. Parameters 'a' and 'b' have descriptions but are generic. No output schema is documented. No error handling guidance. The tool is trivial (arithmetic) and does not reflect production patterns for composition, chaining, or recovery.
Adds two numbers together
Tool description is too brief (22 chars). Must be 50-200 chars and explain WHAT, WHEN, and any prerequisites. Current: 'Adds two numbers together' lacks context for LLM selection.
Output schema not documented. LLMs cannot plan downstream calls or extract results without knowing the response structure. Must document return type (e.g., {result: number}).
No error handling or recovery guidance. If inputs are invalid (non-numeric, NaN, Infinity), the tool provides no actionable error message. Must return 'Invalid input: a and b must be finite numbers' with retry guidance.
Parameters lack format/constraint documentation. Description should state: 'First number to add (any finite number, e.g., -1000 to 1000)' to guide LLM input validation.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Tool is trivial and does not demonstrate production patterns. A real MCP server should include tools for composition (chaining IDs), pagination, error recovery, and idempotency, none present.