Skip to main content
MCP server CX Codex

i18n-agent — Claude Code MCP server for file translation

The i18n-agent MCP server connects to Claude Code to translate text and files with audience and regional context while preserving supported file structures.

MIT updated 2026-05-20

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcp
Open on GitHub

What i18n-agent does

i18n-agent connects a translation service to Claude Code and other supported IDEs over MCP. It can translate individual text or files with guidance about audience and region. Supported formats include JSON, YAML, CSV, XML, Markdown, PDF, and Word documents; structured files retain their format.

You need an I18N_AGENT_API_KEY to use the service. In Claude Code, connect over HTTP or run the client through npx using stdio. The stdio setup also needs MCP_SERVER_URL, so configure both environment values before using that option.

The service covers 48 languages, including regional variants. Files over 50 KB go through asynchronous processing with job status tracking, and large translation jobs can take up to 10 minutes. That means a large file may finish as a tracked job rather than in the agent’s immediate reply.

What it helps with

  • translate JSON while retaining nested structure
  • localize Markdown without translating code blocks
  • adapt copy for a particular region and audience
  • check the remaining translation credits
  • list supported languages and quality ratings

Example prompts for the agent

  • Translate this JSON into French while keeping its nested structure intact.
  • Adapt this text for Spanish readers in Spain and a casual audience.
  • Show me the supported translation languages and their quality ratings.

How to install i18n-agent

1Platform CLI: remote server

claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcp

2Platform CLI

claude mcp add --env I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> --env MCP_SERVER_URL=<MCP_SERVER_URL> --transport stdio i18n-agent -- npx -y @i18n-agent/mcp-client

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about i18n-agent

How do I install i18n-agent in Claude Code?

Run claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcp. You also need an I18N_AGENT_API_KEY for the service.

What does i18n-agent do?

This MCP server gives an agent access to text and file translation with audience and regional context. It can also check translation credits and supported languages.

Which file formats can i18n-agent translate?

Formats include JSON, YAML, CSV, XML, HTML, Markdown, PDF, Word, and gettext files. Files over 50 KB are handled asynchronously with job tracking.

Similar MCP servers

All MCP servers for Programming languages →

Project sponsors

Companies that keep this analytics open