Model Context Protocol · Claude · Cursor · Claude Code

Localize your app from your editor

KAERIS ships a repo-native MCP server: give Claude, Cursor or Claude Code the ability to scan your i18n, find what's missing, and translate your string files into 46 languages — placeholder-safe, incremental, reproducible. No dashboard to sync to.

Read the docs → $ pip install kaeris-mcp

✓ Works on your local files ✓ Repo audit with no API call ✓ 11 formats · 46 languages ✓ Reproducible via kaeris.lock ✓ No account needed

Add it in one line

Claude Code

$ claude mcp add \
  kaeris-i18n kaeris-mcp

Cursor

// .cursor/mcp.json
{ "mcpServers": {
  "kaeris-i18n": {
    "command": "kaeris-mcp" }}}

Claude Desktop

// claude_desktop_config.json
{ "mcpServers": {
  "kaeris-i18n": {
    "command": "kaeris-mcp" }}}

Install once with pip install kaeris-mcp, restart the client, and the KAERIS tools appear automatically. No key required to start.

Seven tools

What your agent can do

The first four run entirely on your machine with no API call and no cost — an agent can audit a repo's i18n before deciding whether to translate anything.

scan_repoDiscover the repo's i18n setup — locale files, base & target languages, framework guess (i18next / next-intl / vue-i18n / Flutter / Android / iOS / gettext).local

statusCompleteness & health per locale — missing keys, extra keys, placeholder mismatches (same as kaeris check --json).local

list_missing_keysThe exact missing/broken keys with source text for one locale — so the agent knows precisely what to fix.local

list_languagesList all 46 supported target languages.local

translateTranslate inline strings → per-language results, with QA (placeholder-loss & overflow flags; verify back-translates to check meaning).translate

translate_fileTranslate a file on disk (JSON / YAML / .strings / .po / ARB / XML / CSV / XLIFF / .properties / .resx / .ftl), optionally incremental — reproducible via kaeris.lock.translate

add_languageBootstrap a brand-new target locale by translating the whole source file into it.translate

Just ask

Example prompts

"Check this repo's i18n and tell me what's missing or broken." — scans and reports, no API call

"Translate the strings in locales/en.json into German, Ukrainian and Japanese."

"Only translate the new keys I added to en.json — don't redo the whole file."

"We don't have Ukrainian yet — add it." — bootstraps a new locale

Why this one

Repo-native, not another dashboard

✓ Works on your real files — reads and writes the locale files in your project. Nothing to upload, no dashboard to keep in sync.

✓ Free, no-cost audit — scan, status and missing-key tools make zero API calls, so an agent can inspect a repo without spending anything.

✓ Reproducible — kaeris.lock records a hash of every string plus the tone, glossary and model that produced it, so agent, teammates and CI agree on what's done.

✓ Placeholder-safe — {{var}}, %s, ICU plurals and inline tags are never dropped or mistranslated.

✓ Same engine everywhere — the MCP server, the kaeris CLI, the REST API and the GitHub Action all share one translation core.

✓ No account to start — the free anonymous tier works out of the box; add a key only when you need higher limits.

Honest scope: KAERIS translates and audits — it is not a full TMS with seats, review workflows or PM integrations. If you need those, a platform like Lokalise or Crowdin is the right tool. If you want your AI agent to localize the files already in your repo, that's exactly what this is for.

Questions

FAQ

What is the KAERIS MCP server?

An MCP server that gives an AI client — Claude Desktop, Cursor, Claude Code, or any MCP client — the ability to localize your app: scan a repo's i18n, report what's missing or broken, and translate string files into 46 languages, all from your editor. Install with pip install kaeris-mcp.

How is it different from other localization MCP servers?

It's repo-native — it works on the local string files in your project, not a hosted dashboard you sync to. Four tools run entirely locally with no API call and no cost, so an agent can audit a repo before translating anything. And output is reproducible via a kaeris.lock file the CLI shares, so agent, teammates and CI stay in sync.

Do I need an account or API key?

No. The free anonymous tier works out of the box (up to 10,000 characters), and the local audit tools need no key at all. A KAERIS API key raises the limits; a Lifetime/BYOK key removes the monthly volume cap using your own AI provider key — but none of that is required to start.

Which formats and clients are supported?

Formats: JSON, YAML, .strings, .po, ARB, Android XML, CSV, XLIFF, .properties, .resx and Mozilla Fluent (.ftl) — 11 in total. Clients: Claude Desktop, Cursor and Claude Code have one-line setup; any MCP-compatible client works.

Give your agent a localization tool

46 languages, 11 formats, placeholder-safe and reproducible — straight from Claude, Cursor or Claude Code. Free to start, no account.

$ pip install kaeris-mcp
$ claude mcp add kaeris-i18n kaeris-mcp

Read the docs →