The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Polytranslator listing page.
Document translation API that keeps the layout. Translate PDFs (including scans), Word, PowerPoint, Excel, EPUB and photos across 475 languages and styles, including ancient and low-resource languages such as Ancient Greek, Coptic and Old English. Native documents keep their format; photos return as PNG and other supported inputs are converted to an editable document format. Text translation, webhooks and a remote MCP server for AI agents use the same prepaid credits. Use an API key for REST integrations or connect an assistant with OAuth. No subscription required.
openapi.json (live at https://www.polytranslator.com/api/openapi.json)https://www.polytranslator.com/api/mcp/.well-known/mcp/server-card.jsonRunnable examples:
| Task | Python | Node | curl |
|---|---|---|---|
| Translate a document | translate_document.py | translate-document.mjs | translate-document.sh |
| Free quote | quote_document.py | ||
| Translate text | translate_text.py | ||
| Verify a webhook | verify_webhook.py | verify-webhook.mjs |
| Formats in | PDF (text-based or scanned), DOCX, PPTX, XLSX, EPUB, PNG, JPG, WEBP, HEIC; DOC, ODT, RTF, TXT, Markdown, HTML, XML, SRT, VTT, TeX, Pages → DOCX; XLS, ODS, CSV, TSV, Numbers → XLSX; PPT, ODP, Keynote → PPTX; MOBI, AZW3, FB2 → DOCX |
| Output | Native PDF, DOCX, PPTX, XLSX and EPUB keep their format; photos return as PNG, and converted inputs use the format shown above. Layout, tables and images are preserved, with scan/photo text translated in place (output=formatted). Or choose translated text only (output=text). |
| Limits | 50 MB, 1,000 PDF pages, 1,000,000 characters per document; 5 documents in progress per account |
| Languages and styles | 475 catalog entries; source auto-detected; GET /v1/languages |
| Tiers | fast and advanced (the most accurate) |
| Price | Prepaid credit packs from $9.99 (300 credits) to $99.99 (5,000). Every document is quoted for free before you pay and charged exactly its quote; failed documents are refunded. Text: 1 credit per 1,000 characters (fast), 3 (advanced). |
| Async | ?wait= long-poll, or a signed webhook (callback_url) when the document finishes |
| Safety | Idempotency-Key on submissions (a retry never charges twice), max_credits spending cap per request |
| Agents | Headless signup and purchase with a Stripe Shared Payment Token, OpenAPI, llms.txt, remote MCP server |
Measured examples on the fast tier: a short Word contract costs 1 credit; a one-page scanned court filing costs 19 credits.
Remote Streamable HTTP server, nothing to install. Tools: translate_document, get_document, quote_document, translate_text, list_languages, get_credit_balance. Completed documents come back as download links that work without a key for 24 hours.
ChatGPT / Claude web connectors (OAuth)
Add https://www.polytranslator.com/api/mcp as a custom connector or MCP server in a client that supports remote MCP and OAuth. Sign in to Polytranslator and approve the connection. You do not need to copy an API key into the assistant. Connector availability depends on your client and account settings.
Each connection can translate documents and text, read your purchased credit balance, and retrieve your account's API document results. It cannot buy credits, change billing settings or manage API keys. Documents and text still spend purchased credits; approving a connection does not buy a credit pack. Any automatic refill you already enabled continues under its existing settings. Revoke a connection from the API dashboard by revoking its MCP: <client name> key.
For implementers: OAuth uses the translation scope and authorization code flow with S256 PKCE. Public clients can use an HTTPS Client ID Metadata Document (CIMD) with token_endpoint_auth_method: none. Dynamic client registration (DCR) also remains available for public clients (none) and confidential clients (client_secret_basic or client_secret_post). Access tokens last one hour; refresh tokens rotate and expire 30 days after connection creation.
The resource is exactly https://www.polytranslator.com/api/mcp; include it in authorization and token requests. The issuer is https://www.polytranslator.com/api/oauth. Discovery endpoints are /.well-known/oauth-protected-resource/api/mcp and /.well-known/oauth-authorization-server/api/oauth.
All MCP transport requests, including initialization and tool listing, require authentication. Missing or invalid credentials receive HTTP 401 with a WWW-Authenticate discovery challenge so clients start OAuth immediately. Directories can inspect the six tools without signing in through the public server card. OAuth access tokens work only through MCP; direct REST requests use API keys.
API-key clients
API-key authentication remains supported. The configurations below use an API key; keep it out of source control. The REST examples and Postman collection also use API keys.
Claude Code
Cursor (.cursor/mcp.json)
VS Code (.vscode/mcp.json)
Codex (~/.codex/config.toml)
Registry entry: mcp/server.json (com.polytranslator/translator). Also listed on Smithery.
A sourced comparison with DeepL, Google Cloud Translation, Azure AI Translator and Amazon Translate (formats, scans, limits, languages, pricing, minimum charges, setup) is at https://www.polytranslator.com/guides/document-translation-api/.
Open the public Postman collection, or import postman/polytranslator.postman_collection.json, and set the apiKey collection variable to your API key. Keep the populated value private; do not include credentials in a published workspace or exported collection. The baseUrl variable defaults to https://www.polytranslator.com/api.
Polytranslator is built by the authors of From LLM to NMT: Advancing Low-Resource Machine Translation with Claude (Enis & Hopkins, 2024, arXiv:2404.13813). Questions: support@polytranslator.com.
The examples in this repository are MIT licensed.