# KAERIS i18n

> KAERIS i18n is a freemium MCP server for developer tools. Check app locale files and translate them into 46 languages from your editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, self-hosted
- **Website:** https://kaeris.dev/mcp-localization.html
- **Repository:** https://github.com/kaeris-io/kaeris-mcp
- **MCP Registry name:** io.github.kaeris-io/kaeris-mcp
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

KAERIS runs as a local server inside Claude Code, Cursor or Claude Desktop and works on the language files in your project. Its first three tools never call a network: they find locale files and the source language, report missing keys and lost placeholders per language, and list the exact keys to fix. Checks include changed numbers, lost inline tags, broken escapes and plural gaps.

Translation goes through KAERIS's API and keeps placeholders and markup. With verify set, each line is translated back to flag a changed meaning, and with only_new set the server translates just new and edited keys, tracking them in a kaeris.lock file that matches the one the command line tool writes. Thirteen formats are supported, including JSON, YAML, .po, ARB, Android XML, XLIFF and Markdown.

Plans: no key is needed to try it, a free key allows 50k characters per file and 8 languages per run, Pro is $19 a month, Team/API is $79 a month and Lifetime is $79 once with your own OpenRouter key.

## Features

- **Offline locale audit:** Finds locale files and reports missing keys and broken placeholders without a network call.
- **Incremental translation:** Translates only new and edited keys, tracked in kaeris.lock.
- **Back-translation check:** verify=true translates each line back to flag a changed meaning.
- **13 file formats:** Handles JSON, YAML, .strings, .xcstrings, .po, ARB, Android XML, CSV, XLIFF and more.
- **Add a language:** Creates a new language file from the whole source.

## Good for

- Find what is broken in a repo's translations
- Translate new strings after a feature change
- Bootstrap a new target language
- Keep an agent, teammates and CI in agreement on what is translated

## Install

### Claude Code (Terminal)

```sh
claude mcp add kaeris-mcp --env KAERIS_API_KEY='<KAERIS_API_KEY>' --env KAERIS_OPENROUTER_KEY='<KAERIS_OPENROUTER_KEY>' -- uvx kaeris-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kaeris-mcp": {
      "command": "uvx",
      "args": [
        "kaeris-mcp"
      ],
      "env": {
        "KAERIS_API_KEY": "<KAERIS_API_KEY>",
        "KAERIS_OPENROUTER_KEY": "<KAERIS_OPENROUTER_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kaeris-mcp": {
      "command": "uvx",
      "args": [
        "kaeris-mcp"
      ],
      "env": {
        "KAERIS_API_KEY": "<KAERIS_API_KEY>",
        "KAERIS_OPENROUTER_KEY": "<KAERIS_OPENROUTER_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kaeris-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kaeris-mcp"
      ],
      "env": {
        "KAERIS_API_KEY": "<KAERIS_API_KEY>",
        "KAERIS_OPENROUTER_KEY": "<KAERIS_OPENROUTER_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kaeris-mcp": {
      "command": "uvx",
      "args": [
        "kaeris-mcp"
      ],
      "env": {
        "KAERIS_API_KEY": "<KAERIS_API_KEY>",
        "KAERIS_OPENROUTER_KEY": "<KAERIS_OPENROUTER_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kaeris-mcp": {
      "command": "uvx",
      "args": [
        "kaeris-mcp"
      ],
      "env": {
        "KAERIS_API_KEY": "<KAERIS_API_KEY>",
        "KAERIS_OPENROUTER_KEY": "<KAERIS_OPENROUTER_KEY>"
      }
    }
  }
}
```

## Tools

- `kaeris_scan_repo`: Finds the language files, source language and framework.
- `kaeris_status`: Per-language missing keys, lost variables and changed numbers.
- `kaeris_list_missing_keys`: The exact missing or broken keys of one language, with source text.
- `kaeris_list_languages`: Lists the 46 language codes.
- `kaeris_translate`: Translates strings the agent passes in, optionally back-translating to verify.
- `kaeris_translate_file`: Translates a file on disk and writes the result.
- `kaeris_add_language`: Creates a new language file from the whole source.

## FAQ

### Do I need an API key?

Not to try it. The README says no key is needed, and a free key raises limits.

### Which tools work offline?

kaeris_scan_repo, kaeris_status and kaeris_list_missing_keys are local-only.

### How is it installed?

Run pip install kaeris-mcp and then claude mcp add kaeris-i18n kaeris-mcp. A Docker option is also described.

### What does the lock file do?

kaeris.lock stores a hash of each source string and the settings that produced it, so only changed strings are re-translated.

### Is KAERIS i18n free?

KAERIS i18n has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add KAERIS i18n to Claude Code?

Run this command in your terminal: claude mcp add kaeris-mcp --env KAERIS_API_KEY='<KAERIS_API_KEY>' --env KAERIS_OPENROUTER_KEY='<KAERIS_OPENROUTER_KEY>' -- uvx kaeris-mcp

### What are the best alternatives to KAERIS i18n?

The closest alternatives to KAERIS i18n are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kaeris-i18n
