An MCP server that fetches Wordle solutions from the New York Times Wordle API
Single tool with clear verb-based naming and explicit schema. Description is adequate but brief (86 chars, below the p10 baseline of 34-392). Parameter 'date' has type and description. Output schema is implicitly documented in WordleAPIData struct but not formally declared in the tool registration. Error handling is present but generic, errors return text strings without actionable recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Composite score reflects: strong naming and schema structure (+), weak output documentation and error messaging (-).
Fetches the Wordle of a particular date provided between 2021-05-19 to 23 days future
Output schema not formally documented in tool definition. WordleAPIData struct exists in code, but the tool registration (mcp.NewTool) does not declare output fields or return type for the LLM.
Error responses lack actionable recovery guidance. Errors are returned as plain text (e.g., 'failed to fetch wordle solution: <error>'), but do not indicate whether the failure is retryable, user-fixable, or fatal. LLM cannot determine next action.
Missing tool annotations. Tool is read-only (fetches data, no state modification), but readOnlyHint is not set. This prevents clients and LLMs from recognizing the tool as safe.
Tool description is brief (86 chars) and does not clearly state WHAT it does, WHEN to use it, and what it returns. Baseline descriptions are 194 chars on average. Current description omits return value summary.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 58 | 2025-06-18+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |
Date parameter lacks format specification in description. States 'YYYY-MM-DD format' as prose but does not document valid range (2021-05-19 to 23 days future) or behavior if date is outside range.