AI Learning Assistant MCP Server providing tools for Wikipedia search, text translation, and dictionary lookup
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools have descriptions (10-50 chars baseline), but descriptions are generic and lack actionable context for LLM selection. Input schemas use Zod validation (good), but parameter descriptions are minimal. No output schemas documented. Error handling is generic (validation errors only). Tools follow verb_noun naming but lack depth in composition guidance.
Looks up word definitions, pronunciations, examples, and synonyms from English dictionary
Searches Wikipedia and returns a summary of the article with link and thumbnail
Translates text from one language to another using Google Translate
Output schemas not documented. LLMs cannot plan downstream calls or extract structured data from results. No documentation of what fields searchWikipedia, translateText, or lookupWord return.
Parameter descriptions are minimal (1-2 words). 'Search query' and 'Text to translate' lack context on format, length rationale, or when to use. Baseline for A+ tools is 72 chars per param; these average ~15 chars.
Tool descriptions are under 50 characters and lack WHEN/WHY context. 'Searches Wikipedia and returns a summary' does not explain when to call this vs. a general search tool, or what 'summary' means (length? fields?). Baseline is 194 chars.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
No error recovery guidance. Generic validation errors ('Validation error') do not tell LLM what to do next. Missing pattern:recovery-guide implementation.
Language code parameters (ISO 639-1) lack enum constraints. LLMs will hallucinate invalid codes. Should declare allowed values or provide a discovery tool.