Equalang Translation
OfficialEqualang Translation is an MCP server for translating files while preserving layout, transcribing recordings, and translating text through Equalang.
Translate whole documents (PDF, DOCX, PPTX, XLSX, EPUB, HTML, TXT) into another language while keeping layout, tables, images, and formulas.
Translate subtitles (SRT/VTT), images (JPG/PNG/WebP/BMP), and audio/video recordings into translated subtitles.
Transcribe audio/video recordings into timed text formats: SRT, VTT, TXT, or JSON.
Translate short text lists or one long text up to 100,000 characters.
Estimate the maximum cost of translating or transcribing a file before starting a job.
Check job status and save results when finished, or cancel queued/running jobs.
Check the account's credit balance.
List supported language codes and names for file or text translation, with optional filtering.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Equalang Translation Translate ~/Documents/contract.pdf into Chinese, keeping the layout."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
equalang-mcp
English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português · Italiano · Русский · Polski · Türkçe · Tiếng Việt · Bahasa Indonesia · ไทย · हिन्दी · العربية
Website · Pricing · Developer docs · API keys
Keywords: document translation, pdf translator, translate pdf keep layout, docx translation, pptx translation, excel translation, epub translation, subtitle translation, srt translator, image translation, video translation, audio transcription, speech to text, ai translator, mcp server, model context protocol, claude mcp, cursor mcp, translation api
Translate the file, keep the layout. An MCP server for Equalang - an AI translator that works on whole files: a PDF comes back as a PDF, a deck as a deck, with tables, images and formulas where they were. It also translates subtitles and pictures, turns audio and video into translated subtitles or a transcript, and translates short texts in bulk. Works in Claude Code, Claude Desktop, Codex, Cursor, Windsurf, Cline, VS Code and every other MCP client.
claude mcp add equalang -s user -e EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcpTry asking
"Translate ~/Documents/contract.pdf into Chinese, keeping the layout."
"Translate pitch-deck.pptx into Japanese and German."
"Translate https://example.com/whitepaper.pdf into Spanish and save it in ~/Downloads."
"How much would it cost to translate thesis.docx into French?"
"Make Korean subtitles for interview.mp4, with the original line above each one."
"Transcribe standup.m4a with timestamps."
"Make an English version of menu.jpg."
"Translate novel.epub into English."
Related MCP server: nativ-mcp
Features
Documents - PDF, DOCX, PPTX, XLSX, EPUB, HTML and TXT come back in the same format, still editable, with tables, images, formulas and page layout in place
Subtitles and pictures - SRT and VTT keep their timing, optionally with the source line above the translation; JPG, PNG, WebP and BMP come back with the text in the picture translated
Audio and video - MP3, M4A, WAV, FLAC, OGG, AAC, Opus, MP4, MOV, WebM and MKV become translated subtitles, or a transcript in the language spoken (SRT, VTT, TXT, JSON)
Text in bulk - short texts translated in order, or one long text (up to 100,000 characters) that Equalang cuts at sentences itself
Languages — 152 for text and documents; the live language list reflects the current deployment. Omit the source language to detect it automatically.
PDF formulas — Formula optimization is optional and off by default. Enable it only for PDF files.
translate_file→optimize_math_formula: trueAdds 10 credits per original PDF page at the default rate. Use the same option when estimating the cost.estimate_cost→optimize_math_formula: true
Get a key
Sign up at https://equalang.com and create a key at https://equalang.com/api-keys. New accounts start with free credits, enough to put a document through.
The key goes in an environment variable of the MCP client's config, never in a URL. Without a key the server still starts and lists its tools; a tool that needs the key answers with how to get one.
The key can also live once per machine, in ~/.config/equalang/.env, which the Equalang skill reads too:
# Replace el_your_key with your key
mkdir -p ~/.config/equalang && echo 'EQUALANG_API_KEY=el_your_key' > ~/.config/equalang/.env && chmod 600 ~/.config/equalang/.envThe server takes EQUALANG_API_KEY from its environment first, and reads the file only when the environment has none: a key in the client config wins, and with the file in place the client config needs no env.
Install
Needs Node 18 or later.
claude mcp add equalang -s user -e EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcp-s user puts it in every project; the default scope, local, loads the server only in the directory the command was run from.
codex mcp add equalang --env EQUALANG_API_KEY=el_your_key -- npx -y @equalang/mcpAdd this to the client's MCP config - claude_desktop_config.json, ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, or the file your client documents:
{
"mcpServers": {
"equalang": {
"command": "npx",
"args": ["-y", "@equalang/mcp"],
"env": { "EQUALANG_API_KEY": "el_your_key" }
}
}
}code --add-mcp '{"name":"equalang","command":"npx","args":["-y","@equalang/mcp"],"env":{"EQUALANG_API_KEY":"el_your_key"}}'Install the Equalang plugin, which runs this server with DeepSeek Harness's own runtime: in Plugins → Add plugin, enter @equalang/dsh-plugin. From a terminal:
dsh plugin --profile web add @equalang/dsh-pluginDeepSeek Harness does not pass an exported EQUALANG_API_KEY to MCP servers, so keep the key in ~/.config/equalang/.env.
Prefer a skill? equalang-skill offers the same operations as an Agent Skill - one Python script, nothing to install.
Tools
Tool | What it does |
| Translate a file (path or public URL) into another language and save the result beside it. |
| Write down what an audio or video file says, as timed text (SRT, VTT, TXT, JSON). |
| Translate short texts, in order - or one long text, which Equalang cuts at sentences itself. |
| Upload a file without starting anything; answers with the most a job on it can cost, and a |
| Pick a job up again, and save its results once it has finished. |
| Stop a queued or running job. A cancelled job is not charged. |
| The account's credits. |
| Every language code and name. Needs no key. |
Language codes look like en, zh-CN, ja; list_languages has the full list. A job takes minutes - a tool waits up to wait_seconds (50 s by default, 240 at most), then hands back a job id for check_job to pick up.
Links
API for agents: llms.txt · llms-full.txt · OpenAPI
equalang-skill - the same operations as an Agent Skill
Questions: support@equalang.com
License
Apache-2.0 © Equalang
Available Tools
8 toolscancel_jobCancel a jobADestructiveIdempotent
Stop a queued or running job. A cancelled job is not charged; one that had already finished is left as it is.
Inputs: job_id (required).
check_jobCheck a jobA
Look a job up by id and, if it has finished, save its results. Use after a tool answered before its job was done.
Inputs: job_id (required), output_dir, wait_seconds.
estimate_costEstimate what a file will costA
Upload a local file without starting anything, and answer with the most a job on it can cost in credits. Free. Pass the returned file_id to translate_file or transcribe_recording so the file is not uploaded twice; kept_until says how long it is held. A recording is charged for the speech actually heard, usually less than the estimate.
Inputs: path (required).
get_credit_balanceCheck the credit balanceARead-only
How many credits the account has. Credits are bought at https://equalang.com/pricing; the same balance serves the website and this server.
Inputs: no named parameters.
list_languagesList the languagesARead-only
The language codes Equalang takes, with their names, read from the live API. Needs no key. Use it to turn a language's name into its code.
Inputs: kind, matching.
transcribe_recordingTranscribe a recordingA
Write down what is said in an audio or video file (mp3, m4a, wav, flac, ogg, aac, opus, mp4, mov, webm, mkv) as timed text, in the language spoken, and save it. For a translation of the recording use translate_file instead. Charged for the speech actually heard: silence and music are not. COSTS THE USER'S CREDITS: say what it will cost and get their agreement first -- estimate_cost gives the number for a file.
Inputs: source, file_id, output_dir, wait_seconds, +2 more.
translate_fileTranslate a fileA
Translate a whole file into another language and save the result, keeping its layout, tables, images and formulas. Documents (pdf, docx, pptx, xlsx, epub, html, txt), subtitles (srt, vtt), pictures (jpg, png, webp, bmp), and recordings (mp3, m4a, wav, flac, ogg, aac, opus, mp4, mov, webm, mkv), which come back as translated subtitles. Answers with the paths written, never the contents. COSTS THE USER'S CREDITS: say what it will cost and get their agreement first -- estimate_cost gives the number for a file.
Inputs: target_language (required), source, file_id, bilingual, +4 more.
translate_textTranslate textA
Translate plain text and answer with the translation. Pass texts for separate strings -- labels, messages: each translated on its own, answered in order, at most 50 texts of 5,000 characters, 20,000 characters per call. Pass text for one long text -- an article, a chapter, up to 100,000 characters: it is cut at sentences by Equalang, so do not split it yourself. For anything that is a file, use translate_file, which keeps its formatting. Charged by length, a small amount; the answer says how much.
Inputs: target_language (required), text, texts, source_language.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct purposes: credit balance, language listing, file translation, recording transcription, text translation, cost estimation, job checking, and job cancellation. The only potential confusion is between translate_file and transcribe_recording for recordings, but the descriptions clearly separate them (translation vs. transcription).
Tool names follow a consistent verb_noun pattern: get_credit_balance, list_languages, translate_file, transcribe_recording, translate_text, estimate_cost, check_job, cancel_job. All are lowercase with underscores and use imperative verbs, though the verbs vary (get, list, translate, transcribe, estimate, check, cancel) which is natural for the actions.
8 tools is well-scoped for a translation/transcription server. Each tool covers a distinct operation: balance check, language lookup, file translation, recording transcription, text translation, cost estimation, job status, and job cancellation. No redundant tools.
The server covers the full workflow: estimate cost, submit translation/transcription, check job status, cancel jobs, and check credits. Minor gaps include no tool to list past jobs or retrieve previously saved results without a job id, but the core lifecycle is complete.
Maintenance
Related MCP Connectors
Translate PDFs, scans, Office files and EPUB across 475 languages and styles, preserving layout.
Localize text, images, audio and subtitles with brand voice, memory and style guides.
Accurate, brand-controlled translation for text, code, images, and documents with terminology.
MotaWord MCP Server for professional and certified translations and localization
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables translation and text rephrasing using DeepL's API through a cloud-deployed MCP server. Provides translation between multiple languages, text rephrasing, and language detection capabilities with professional deployment features.MIT

nativ-mcpofficial
AlicenseAqualityBmaintenanceAI-powered localization platform. Translate text, search translation memory, and access style guides from any MCP-compatible AI tool.2162 PyPI1MIT- AlicenseNot gradedqualityCmaintenanceAI-powered translation MCP server with EU AI Act compliance, enabling automated translation workflows via the MCP protocol.3 npm26 PyPIMIT
- FlicenseAqualityCmaintenanceEnables broad media and document format conversion (audio, video, images, Office, data, ebooks, PDF, subtitles) through an MCP server with smart routing, batch processing, and multiple conversion engines.14-