@babelize/mcp

MCP (Model Context Protocol) server for Babelize — let AI coding agents translate your apps directly from your editor.

Works with any MCP-compatible client: Cursor, Claude Desktop, opencode, VS Code (via extension), and more.

Install

npm install -g @babelize/mcp

Or run on-demand without installing:

npx -y @babelize/mcp

Quick Start

1. Get an API key from babelize.co
2. Set your API key:

export BABELIZE_API_KEY=bblz_sk_...

Or create .babelize/config.json in your project:

{ "apiKey": "bblz_sk_..." }

3. Configure your editor (see below)

IDE Configuration

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp"],
      "env": {
        "BABELIZE_API_KEY": "bblz_sk_..."
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp"]
    }
  }
}

opencode

Add to .opencode.json:

{
  "mcpServers": {
    "babelize": {
      "command": "npx",
      "args": ["-y", "@babelize/mcp"],
      "env": []
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | babelize_run_start | Start a translation pipeline run for the project | | babelize_run_status | Check the status of a running translation | | babelize_glossary_get | View the translation glossary | | babelize_glossary_set | Add or update terms in the translation glossary | | babelize_scan | Scan project files for translatable strings | | babelize_status | Check Babelize API server health |

Configuration

The server resolves configuration in this priority order:

1. CLI args — --api-key, --api-url, --api-base
2. Environment variables — BABELIZE_API_KEY, BABELIZE_API_URL
3. Local config file — .babelize/config.json in the current working directory

Options

| Option / Env Var | Description | Default | |-----------------|-------------|---------| | --api-key / BABELIZE_API_KEY | Your Babelize API key | — | | --api-url / BABELIZE_API_URL | API base URL | https://api.babelize.co/api | | --api-base | API base path (without /api suffix) | — |

Links

• Website
• Docs
• GitHub
• npm