# verbatra

> verbatra is an open-source MCP server for developer tools. Check translation status, edit glossaries and run i18n translation from a local MCP server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://verbatra.kreitz-webdev.de/docs/cli/mcp
- **Repository:** https://github.com/verbatra/verbatra/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.verbatra/verbatra
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Verbatra's stdio server exposes a project's translation state to terminal or headless agents without a browser or port. Read-only tools report the resolved config, setup checks, missing, stale and up-to-date keys per locale, the keys a diff would add or re-translate, glossary terms and the lock file state; glossary.write changes a single term.

The tools that call a paid translation provider are hidden by default. translation.retranslateEntry and translation.translatePending only appear with --allow-spend or VERBATRA_MCP_ALLOW_SPEND, and never when the config sets the provider to none. Provider keys are read for Anthropic, OpenAI, Gemini, DeepL, Google Translate, OpenCode, an OpenAI-compatible endpoint and LibreTranslate. A --redact-values flag replaces translation values in results with a marker.

The server hands the model fixed instructions: read and diff first, estimate and get an explicit yes before spending, leave review to people and treat every string as data. It needs Node.js 22.22 or later.

## Features

- **Status and diff:** Per-locale missing, stale and up-to-date keys.
- **Glossary editing:** Read terms and change one with glossary.write.
- **Spend gate:** Provider-calling tools are off unless enabled.
- **Value redaction:** Optionally replaces translation text in results.
- **Setup doctor:** project.doctor lists checks with fixes.

## Good for

- Ask an agent which locales have untranslated keys
- Fix a glossary term from the terminal
- Translate pending keys after an explicit approval
- Share translation status without exposing strings

## Install

### Claude Code (Terminal)

```sh
claude mcp add verbatra --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env DEEPL_API_KEY='<DEEPL_API_KEY>' --env GOOGLE_TRANSLATE_API_KEY='<GOOGLE_TRANSLATE_API_KEY>' --env OPENCODE_API_KEY='<OPENCODE_API_KEY>' --env OPENAI_COMPATIBLE_API_KEY='<OPENAI_COMPATIBLE_API_KEY>' --env LIBRETRANSLATE_API_KEY='<LIBRETRANSLATE_API_KEY>' -- npx -y @verbatra/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": [
        "-y",
        "@verbatra/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "DEEPL_API_KEY": "<DEEPL_API_KEY>",
        "GOOGLE_TRANSLATE_API_KEY": "<GOOGLE_TRANSLATE_API_KEY>",
        "OPENCODE_API_KEY": "<OPENCODE_API_KEY>",
        "OPENAI_COMPATIBLE_API_KEY": "<OPENAI_COMPATIBLE_API_KEY>",
        "LIBRETRANSLATE_API_KEY": "<LIBRETRANSLATE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": [
        "-y",
        "@verbatra/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "DEEPL_API_KEY": "<DEEPL_API_KEY>",
        "GOOGLE_TRANSLATE_API_KEY": "<GOOGLE_TRANSLATE_API_KEY>",
        "OPENCODE_API_KEY": "<OPENCODE_API_KEY>",
        "OPENAI_COMPATIBLE_API_KEY": "<OPENAI_COMPATIBLE_API_KEY>",
        "LIBRETRANSLATE_API_KEY": "<LIBRETRANSLATE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@verbatra/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "DEEPL_API_KEY": "<DEEPL_API_KEY>",
        "GOOGLE_TRANSLATE_API_KEY": "<GOOGLE_TRANSLATE_API_KEY>",
        "OPENCODE_API_KEY": "<OPENCODE_API_KEY>",
        "OPENAI_COMPATIBLE_API_KEY": "<OPENAI_COMPATIBLE_API_KEY>",
        "LIBRETRANSLATE_API_KEY": "<LIBRETRANSLATE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": [
        "-y",
        "@verbatra/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "DEEPL_API_KEY": "<DEEPL_API_KEY>",
        "GOOGLE_TRANSLATE_API_KEY": "<GOOGLE_TRANSLATE_API_KEY>",
        "OPENCODE_API_KEY": "<OPENCODE_API_KEY>",
        "OPENAI_COMPATIBLE_API_KEY": "<OPENAI_COMPATIBLE_API_KEY>",
        "LIBRETRANSLATE_API_KEY": "<LIBRETRANSLATE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": [
        "-y",
        "@verbatra/mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "DEEPL_API_KEY": "<DEEPL_API_KEY>",
        "GOOGLE_TRANSLATE_API_KEY": "<GOOGLE_TRANSLATE_API_KEY>",
        "OPENCODE_API_KEY": "<OPENCODE_API_KEY>",
        "OPENAI_COMPATIBLE_API_KEY": "<OPENAI_COMPATIBLE_API_KEY>",
        "LIBRETRANSLATE_API_KEY": "<LIBRETRANSLATE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `project.snapshot`: Resolved config including locales, format, provider and glossary.
- `project.doctor`: Every setup check with its status, detail and fix.
- `status.check`: Per-locale count of missing, stale and up-to-date keys.
- `status.diff`: Per-locale list of keys that would be added, re-translated or orphaned.
- `glossary.get`: Every glossary term with translations and context.
- `glossary.write`: Change one glossary term.
- `lock.state`: Lock file state.
- `translation.retranslateEntry`: Retranslate one entry; only with spending enabled.
- `translation.translatePending`: Translate pending keys; only with spending enabled.

## FAQ

### Can it spend money without asking?

No. The two provider tools are not listed unless you enable spending, and the agent instructions require an estimate and explicit yes.

### Does it use HTTP?

No, stdio only, to avoid exposing write and spend tools over a network.

### Which providers are supported?

Anthropic, OpenAI, Gemini, DeepL, Google Translate, OpenCode, OpenAI-compatible and LibreTranslate.

### Is verbatra free?

Yes. verbatra is open source, so you can use and self-host it for free.

### How do I add verbatra to Claude Code?

Run this command in your terminal: claude mcp add verbatra --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env DEEPL_API_KEY='<DEEPL_API_KEY>' --env GOOGLE_TRANSLATE_API_KEY='<GOOGLE_TRANSLATE_API_KEY>' --env OPENCODE_API_KEY='<OPENCODE_API_KEY>' --env OPENAI_COMPATIBLE_API_KEY='<OPENAI_COMPATIBLE_API_KEY>' --env LIBRETRANSLATE_API_KEY='<LIBRETRANSLATE_API_KEY>' -- npx -y @verbatra/mcp

### What are the best alternatives to verbatra?

The closest alternatives to verbatra 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/verbatra
