Model Context Protocol (MCP) server that exposes DeepL translation capabilities to Claude, Claude Desktop, and other MCP-compatible AI clients
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names are action-oriented (translate, languages, usage) but descriptions lack depth on when/why to use each tool. The 'languages' tool has an enum constraint on 'resource' parameter, which is good, but 'translate' lacks formality enum validation guidance in description. No output schemas documented for any tool. Error handling and recovery guidance absent.
List supported languages for a given resource type
Translate text to a target language using DeepL API
Check API quota and usage for your DeepL account
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields without knowing response structure.
'usage' tool has empty input schema (no properties defined). Description is only 35 chars ('Check API quota and usage for your DeepL account'), insufficient for LLM selection.
'translate' description lacks guidance on when to use formality parameter or how glossary_id affects output. Missing dependency hints for multi-step workflows.
'languages' description (47 chars) is too brief. Does not explain what structure is returned or when to call it relative to translate.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
No error handling guidance in any tool description. LLMs cannot self-correct on API failures (e.g., invalid language code, quota exceeded).