Skip to content
MCP server

KAERIS i18n

Check app locale files and translate them into 46 languages from your editor

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.18
Listing updated
3 days ago

About KAERIS i18n

KAERIS i18n is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • KAERIS_API_KEYKAERIS API key (optional; the free demo works without one)
  • KAERIS_OPENROUTER_KEYOpenRouter key for the Lifetime (BYOK) plan (optional)

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $19 a month

Free key; Pro $19/mo, Team/API $79/mo, Lifetime $79 once with your own OpenRouter key

Prices change. Check kaeris.dev before you buy.

KAERIS i18n 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 to KAERIS i18n

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools