deepl-mcp-server
MCP Server for DeepL Translation API
Install / Use
claude mcp add watchdealer-pavel -- npx -y github:watchdealer-pavel/deepl-mcp-serverIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of deepl-mcp-server
deepl-mcp-server scores 70/100 on our quality scale, 3877th of 4,700 Development & Engineering skills we index.
Its MCP Server is 7.9 KB long, well organised into 28 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-09-23 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 81/100, with 3 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
deepl-mcp-server compared with similar skills
All 4 of these similar skills score higher than deepl-mcp-server; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| deepl-mcp-server (this skill)by watchdealer-pavel | 70 | 3 | 7mo ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install deepl-mcp-server?
- Run
claude mcp add watchdealer-pavel -- npx -y github:watchdealer-pavel/deepl-mcp-server. The install tabs above show the steps for each supported agent. - Which AI agents does deepl-mcp-server work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is deepl-mcp-server safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 81/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is deepl-mcp-server still maintained?
- The repository was last updated about 7 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubDeepL MCP Server
An MCP (Model Context Protocol) server providing high-quality translation capabilities via the DeepL API.
Features
This server provides 24 tools for working with DeepL:
| Tool | Description | Required Params |
|------|-------------|-----------------|
| translate_text | Translate text with formality, context, glossary, model, tag-handling, style, translation-memory, and custom-instruction options | text, target_lang |
| rephrase_text | Improve text clarity and style using DeepL Write with optional writing style and tone | text |
| get_source_languages | List v2 source languages | — |
| get_target_languages | List v2 target languages with formality support info | — |
| get_usage | Get API usage statistics | — |
| get_languages_v3 | Retrieve beta v3 supported languages by product with feature metadata | — |
| get_language_products_v3 | Retrieve beta v3 language products and feature rules | — |
| get_glossary_language_pairs | List language pairs supported by glossaries | — |
| list_glossaries | List v3 glossaries | — |
| get_glossary | Retrieve v3 glossary metadata | glossary_id |
| get_glossary_entries | Retrieve glossary dictionary entries | glossary_id |
| create_glossary | Create a v3 multilingual glossary | name, dictionaries |
| delete_glossary | Delete a v3 glossary | glossary_id |
| list_translation_memories | List v3 translation memories available to the account | — |
| list_style_rules | List v3 style rule lists | — |
| get_style_rule | Retrieve a v3 style rule list | style_id |
| create_style_rule | Create a v3 style rule list | name, language |
| update_style_rule | Update a v3 style rule list name | style_id, name |
| delete_style_rule | Delete a v3 style rule list | style_id |
| request_voice_session | Request a DeepL Voice realtime WebSocket session | source_media_content_type, target_languages |
| reconnect_voice_session | Request a replacement DeepL Voice realtime token | — |
| upload_document | Upload a local file for document translation | file_path, target_lang |
| get_document_status | Check document translation status | document_id, document_key |
| download_document | Download a translated document to a local path | document_id, document_key, output_path |
Translation Features
- Next-gen model selection — Use
model_typevalues such asquality_optimizedorprefer_quality_optimized - Formality control — Adjust tone for formal/informal contexts
- Context parameter — Provide additional context for better accuracy (not billed)
- Glossary support — Create, list, inspect, use, and delete DeepL v3 glossaries
- Batch translation — Translate multiple texts in a single request
- Preserve formatting — Keep original text formatting
- HTML/XML tag handling — Use
tag_handling,tag_handling_version,ignore_tags,splitting_tags, and related options - Billing visibility — Use
show_billed_charactersto include billed character counts in translation responses - Document translation — Upload, poll, and download translated files
- v3 language metadata — Retrieve product-specific language support and feature rules
- Translation memories — List account translation memories and use them in translation requests
- Style rules — List, create, inspect, rename, delete, and use style rule lists
- Voice session setup — Request or reconnect DeepL Voice realtime WebSocket sessions; audio streaming is done by the returned WebSocket URL
- DeepL Write options — Rephrase with
writing_styleandtonewhen the plan supports Write API - Sentence splitting control — Control how sentences are split
API Type Auto-Detection
The server automatically detects whether you're using the Free or Pro API based on your key format:
- Keys ending in
:fx→ Free API (api-free.deepl.com) - Other keys → Pro API (
api.deepl.com)
Prerequisites
- Node.js 18+ (including Node.js 25)
- DeepL API Key — Sign up here (Free tier available)
Quick Start
1. Clone and Build
git clone https://github.com/watchdealer-pavel/deepl-mcp-server.git
cd deepl-mcp-server
npm install
2. Configure Your MCP Client
Add to your MCP client configuration:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"deepl": {
"command": "node",
"args": ["/path/to/deepl-mcp-server/build/index.js"],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}
Claude Code (.mcp.json in your project):
{
"mcpServers": {
"deepl": {
"command": "node",
"args": ["/path/to/deepl-mcp-server/build/index.js"],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}
3. Restart Your MCP Client
Restart Claude Desktop or Claude Code to load the server.
Usage Examples
Basic Translation
{
"text": "Hello, how are you?",
"target_lang": "DE"
}
Formal Translation with Context
{
"text": "Thanks for your help!",
"target_lang": "DE",
"formality": "more",
"context": "Business email to a client"
}
Batch Translation
{
"text": ["Hello", "Goodbye", "Thank you"],
"target_lang": "FR"
}
Check API Usage
Use get_usage to see your current quota:
{
"character_count": 12500,
"character_limit": 500000,
"characters_remaining": 487500,
"percent_used": "2.50%",
"api_type": "Free"
}
Supported Languages
Source Languages (auto-detected if omitted)
AR, BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH
Target Languages
All source languages plus regional variants:
EN-GB— British EnglishEN-US— American EnglishPT-BR— Brazilian PortuguesePT-PT— European PortugueseZH-HANS— Simplified ChineseZH-HANT— Traditional Chinese
Use get_target_languages for a complete list with formality support indicators.
Error Handling
The server handles common API errors:
- 400 — Invalid parameters
- 401/403 — Authentication failed or feature not available on the current plan
- 429 — Rate limit exceeded
- 456 — Quota exceeded
Security and OSV Status
This repository has been scanned with Google's OSV-Scanner and remediated to a clean state.
- Latest scan result: 0 known dependency vulnerabilities
- Reports are written to
.osv/osv-report.jsonand.osv/osv-summary.md - Remediation notes are in
.osv/remediation-notes.md - The vulnerable direct dependency chains were fixed by upgrading
@modelcontextprotocol/sdkandaxios
Run the scan locally:
export PATH="$HOME/.local/bin:$PATH"
osv-project-scan .
Development
# Watch mode (auto-rebuild)
npm run watch
# Manual build
npm run build
# Run the server
npm start
# Test with MCP Inspector
npm run inspector
# Run live end-to-end tests against DeepL API
# Requires DEEPL_API_KEY in the environment and consumes a small number of billable characters.
npm run test:live
The live test exercises translation, language listing, v3 language metadata, translation-memory listing, style-rule listing/create/get/update/delete when available, voice session request when available, usage, glossary create/use/delete, document upload/status/download, and DeepL Write. Free API keys may return an expected plan error for DeepL Write.
License
MIT License — see LICENSE file.
Links
- DeepL API Documentation
- DeepL Pro API — Sign up for API access
- Model Context Protocol — MCP documentation
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
