MCP Server

The Babelize MCP Server provides seamless integration between your IDE or AI client and the Babelize localization platform. By running the MCP server, AI coding agents (Cursor, Claude Desktop, opencode) can scan, configure, and trigger translation pipelines directly within their conversation context.

Installation

npm install -g @babelize/mcp

Or run on-demand:

npx -y @babelize/mcp

Quick Start

Get an API key — Dashboard → Settings → API Keys

Set the key:

export BABELIZE_API_KEY=bblz_sk_...

Or create .babelize/config.json:

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

Configure your client (see below)

Client Setup

Cursor

.cursor/mcp.json or Settings → Beta → MCP → Add New:

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

Claude Desktop

claude_desktop_config.json:

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

opencode

.opencode.json:

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

Available Tools

Tool	Parameters	Description	Auth
`babelize_scan`	`directory` (required), `extensions` (optional)	Scan a local directory for hardcoded strings	No
`babelize_scan_strings`	`code` (required)	Extract translatable strings from a code snippet	No
`babelize_run`	`project_id` (required), `target_locales` (required), `source_locale` (optional)	Trigger a translation run	Yes
`babelize_status`	`babel_id` (required)	Check status of a translation run	Yes
`babelize_glossary_get`	`project_id` (required), `search` (optional)	List glossary entries for a project	Yes
`babelize_glossary_set`	`project_id` (required), `source` (required), `target` (required), `type` (optional), `locale` (optional)	Add a glossary entry	Yes

No-Auth Tools

babelize_scan and babelize_scan_strings work without an API key — perfect for letting AI agents explore your codebase before you commit.

Configuration Priority

CLI Arguments — --api-key, --api-url, --api-base
Environment Variables — BABELIZE_API_KEY, BABELIZE_API_URL
Local Config File — .babelize/config.json

Options

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

MCP Server

On this page