A remote MCP server with OAuth 2.0 authentication provider, built on Cloudflare Workers. Demonstrates MCP tool registration and OAuth authorization flows.
Single tool 'add' has a basic schema with typed parameters (number, number) and minimal description. The tool name lacks a verb prefix (should be 'add_numbers' or similar per verb_noun convention). Description is only 28 characters, below the 50-200 char baseline for LLM-optimized descriptions. No parameter descriptions provided, violating the critical requirement that every parameter must have a description explaining what it controls. Output schema is not documented. No error handling guidance. The tool is READ_ONLY (safe), but lacks the depth expected of production tools.
Adds two numbers together
Tool name 'add' lacks action verb prefix. Should follow verb_noun convention (e.g., 'add_numbers'). LLMs rely on verb-prefixed names to infer intent before reading descriptions.
Tool description is only 28 characters ('Adds two numbers together'). Baseline for LLM-optimized descriptions is 50 - 200 chars. Current description lacks context on when to use this tool, prerequisites, or what it returns.
Parameters 'a' and 'b' have no descriptions. Critical rule: every parameter must have a description explaining what it controls. LLMs cannot infer meaning from names alone.
Output schema is not documented. LLMs need to know what fields to expect in the response to plan downstream calls and extract data correctly.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No error handling guidance. Tool lacks documentation on what errors can occur, whether they are retryable, and what the LLM should do next.