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
claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcpWhat 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/mcp2Platform 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-clientReplace <…> with your own values
1Platform CLI: remote server
codex mcp add i18n-agent --url https://mcp.i18nagent.ai/mcp2Platform CLI
codex mcp add i18n-agent --env I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> --env MCP_SERVER_URL=<MCP_SERVER_URL> -- npx -y @i18n-agent/mcp-clientReplace <…> with your own values
Config file
{
"mcpServers": {
"i18n-agent": {
"url": "https://mcp.i18nagent.ai/mcp"
}
}
}{
"mcpServers": {
"i18n-agent": {
"command": "npx",
"args": [
"-y",
"@i18n-agent/mcp-client"
],
"env": {
"I18N_AGENT_API_KEY": "<I18N_AGENT_API_KEY>",
"MCP_SERVER_URL": "<MCP_SERVER_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"i18n-agent": {
"type": "http",
"url": "https://mcp.i18nagent.ai/mcp"
}
}
}{
"servers": {
"i18n-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@i18n-agent/mcp-client"
],
"env": {
"I18N_AGENT_API_KEY": "<I18N_AGENT_API_KEY>",
"MCP_SERVER_URL": "<MCP_SERVER_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http i18n-agent https://mcp.i18nagent.ai/mcp2Platform CLI
gemini mcp add -e I18N_AGENT_API_KEY=<I18N_AGENT_API_KEY> -e MCP_SERVER_URL=<MCP_SERVER_URL> i18n-agent npx -y @i18n-agent/mcp-clientReplace <…> 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.