# i18n-agent

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: i18n-agent
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/i18n-agent/mcp-client
- Updated: 2026-05-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/i18n-agent

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.i18nagent.ai/mcp`
- Environment variables: `I18N_AGENT_API_KEY`, `MCP_SERVER_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http i18n-agent https://mcp.i18nagent.ai/mcp
```

2. **Platform CLI**
```bash
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

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add i18n-agent --url https://mcp.i18nagent.ai/mcp
```

2. **Platform CLI**
```bash
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-client
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "i18n-agent": {
            "url": "https://mcp.i18nagent.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "i18n-agent": {
            "type": "http",
            "url": "https://mcp.i18nagent.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http i18n-agent https://mcp.i18nagent.ai/mcp
```

2. **Platform CLI**
```bash
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-client
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [i18n-specialist](https://affpapa.org/en/nevibecode/agents/i18n-specialist.md) — subagent · ★ 489 repo stars
- [i18n-parity](https://affpapa.org/en/nevibecode/skills/i18n-parity.md) — skill · ★ 1198 repo stars
- [internationalization-i18n](https://affpapa.org/en/nevibecode/skills/aj-geddes-internationalization-i18n.md) — skill · 648 installs
- [i18n-localization](https://affpapa.org/en/nevibecode/skills/i18n-localization.md) — skill · 251 installs
- [i18n-strings](https://affpapa.org/en/nevibecode/skills/i18n-strings.md) — skill · ★ 1120 repo stars
- [wiki-i18n](https://affpapa.org/en/nevibecode/rules/wiki-i18n.md) — rule · ★ 1198 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
