Translate documents, subtitles, images, audio and video while keeping the original layout, and transcribe recordings.
Also known as equalang/equalang-mcp, @equalang/mcp
- Stars
- 22
- Tools
- 8
- Downloads, 30 days
- 296
- Latest version
- 0.2.4
- Last commit
- Nov 3, 2026
- License
- Apache-2.0
What is Equalang MCP?
Equalang translates documents, subtitles, images, audio and video while keeping the original layout, and transcribe recordings. It exposes 8 tools, such as translate_file, transcribe_recording, translate_text.
Summary generated from the project's README
About Equalang MCP server
Translating complex documents while preserving their original structure is what equalang-mcp enables for developers and researchers. This server connects AI clients like Claude Desktop, Cursor, Windsurf, and VS Code to the Equalang translation engine, allowing users to process entire files such as PDFs, DOCX, PPTX, and XLSX. Unlike simple text translators, it maintains tables, images, and formulas in their original positions.
Users can also handle multimedia tasks including image translation for formats like PNG or WebP, and converting audio or video files into transcribed text or subtitles. The server requires an EQUALANG_API_KEY provided via environment variables or a local configuration file. It provides specific tools like translate_file, transcribe_recording, and estimate_cost to manage workflows. For PDF files, an optional math formula optimization feature is available to ensure technical accuracy.
What you can do with it
- 1Preserve document layoutsTranslate a complex PDF or PowerPoint presentation into another language without losing the original formatting or images.
- 2Transcribe multimedia filesConvert an audio recording or a video file into a timed transcript or subtitle file.
- 3Estimate translation expensesCalculate the potential cost of a translation job before committing to the process.
- 4Translate visual contentConvert text within an image file into a different language.
Written from the project's README. Every use case is checked against a quote from it.
How to install Equalang MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Equalang MCP in Claude Code
$ claude mcp add --env 'EQUALANG_API_KEY=<YOUR_EQUALANG_API_KEY>' equalang-mcp -- npx -y @equalang/mcpInstall Equalang MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"equalang-mcp": {
"command": "npx",
"args": [
"-y",
"@equalang/mcp"
],
"env": {
"EQUALANG_API_KEY": "<YOUR_EQUALANG_API_KEY>"
}
}
}
}Install Equalang MCP in VS Code
.vscode/mcp.json
{
"servers": {
"equalang-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@equalang/mcp"
],
"env": {
"EQUALANG_API_KEY": "<YOUR_EQUALANG_API_KEY>"
}
}
}
}Install Equalang MCP in VS Code CLI
$ code --add-mcp '{"name":"equalang-mcp","type":"stdio","command":"npx","args":["-y","@equalang/mcp"],"env":{"EQUALANG_API_KEY":"<YOUR_EQUALANG_API_KEY>"}}'Install Equalang MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"equalang-mcp": {
"command": "npx",
"args": [
"-y",
"@equalang/mcp"
],
"env": {
"EQUALANG_API_KEY": "<YOUR_EQUALANG_API_KEY>"
}
}
}
}Install Equalang MCP in Codex
$ codex mcp add equalang-mcp --env 'EQUALANG_API_KEY=<YOUR_EQUALANG_API_KEY>' -- npx -y @equalang/mcpInstall Equalang MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.equalang-mcp] command = "npx" args = ["-y", "@equalang/mcp"] [mcp_servers.equalang-mcp.env] EQUALANG_API_KEY = "<YOUR_EQUALANG_API_KEY>"
Install Equalang MCP in Gemini CLI
$ gemini mcp add -s user -e 'EQUALANG_API_KEY=<YOUR_EQUALANG_API_KEY>' equalang-mcp npx -- -y @equalang/mcpInstall Equalang MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"equalang-mcp": {
"command": "npx",
"args": [
"-y",
"@equalang/mcp"
],
"env": {
"EQUALANG_API_KEY": "<YOUR_EQUALANG_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @equalang/mcp 0.2.4 in an isolated container with no network and no keys. It answered and listed 8 tools.
Equalang MCP tools 8
Read from the server with tools/listtranslate_fileActionTranslate 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.
transcribe_recordingActionWrite 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.
translate_textActionTranslate 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.
estimate_costActionUpload 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.
check_jobActionLook a job up by id and, if it has finished, save its results. Use after a tool answered before its job was done.
cancel_jobActionStop a queued or running job. A cancelled job is not charged; one that had already finished is left as it is.
get_credit_balanceRead-onlyHow many credits the account has. Credits are bought at https://equalang.com/pricing; the same balance serves the website and this server.
list_languagesRead-onlyThe 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.
Configuration
EQUALANG_API_KEYRequiredSecretEqualang API key. Create one at https://equalang.com/api-keys
EQUALANG_API_KEY
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableequalang/equalang-mcp is public and reachablegithub.com/equalang/equalang-mcp ↗Pass
- Package names this repository as its source@equalang/mcp names equalang/equalang-mcp as sourcenpmjs.com/package/@equalang/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/equalang/equalang-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @equalang/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubequalang-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/mcp
Try 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."
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/.env
The 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/mcp
Add 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-plugin
DeepSeek 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_file |
Translate a file (path or public URL) into another language and save the result beside it. |
transcribe_recording |
Write down what an audio or video file says, as timed text (SRT, VTT, TXT, JSON). |
translate_text |
Translate short texts, in order - or one long text, which Equalang cuts at sentences itself. |
estimate_cost |
Upload a file without starting anything; answers with the most a job on it can cost, and a file_id that starts the job without a second upload. Free. |
check_job |
Pick a job up again, and save its results once it has finished. |
cancel_job |
Stop a queued or running job. A cancelled job is not charged. |
get_credit_balance |
The account's credits. |
list_languages |
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
- Equalang · Pricing · Developer docs
- 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
Equalang MCP questions
How do I add Equalang MCP to Claude Code?
Run claude mcp add --env 'EQUALANG_API_KEY=<YOUR_EQUALANG_API_KEY>' equalang-mcp -- npx -y @equalang/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Equalang MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Equalang MCP provide?
It exposes 8 tools, including translate_file, transcribe_recording, translate_text, estimate_cost, check_job.
Which file formats can Equalang translate?
It translates PDF, DOCX, PPTX, XLSX, EPUB, HTML, TXT, SRT, VTT and common image formats, plus audio and video files. Documents come back in the same format with layout kept.
How do I authenticate the Equalang MCP server?
Put your Equalang API key in the EQUALANG_API_KEY environment variable in your MCP client config, or in ~/.config/equalang/.env. Without a key the server still starts but tools that need it will not run.
Can Equalang transcribe audio and video recordings?
Yes, it turns audio and video files into timed text such as SRT, VTT, TXT or JSON. Supported formats include MP3, M4A, WAV, FLAC, OGG, AAC, Opus, MP4, MOV, WebM and MKV.
Can I check the cost of a translation before starting it?
Yes, the estimate_cost tool uploads a file without starting a job and returns the maximum possible cost plus a file_id. It is free to use.
Does Equalang keep the original layout of translated documents?
Yes, tables, images, formulas and page layout stay in place in editable output. Translating formulas in PDFs is an optional extra that costs credits per page.