com.translatize/mcp

Official registry Search and web

Read, search, edit and branch Translatize translation labels and fill missing translations.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @translatize/mcp
Claude Code
claude mcp add com-translatize-mcp -e 'TRANSLATIZE_API_TOKEN=<your translatize_api_token>' -e 'TRANSLATIZE_API_URL=https://api.translatize.com/v1' -e 'TRANSLATIZE_APP_URL=https://app.translatize.com' -- npx -y @translatize/mcp@0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "com-translatize-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@translatize/mcp@0.1.3"
            ],
            "env": {
                "TRANSLATIZE_API_TOKEN": "<your translatize_api_token>",
                "TRANSLATIZE_API_URL": "https://api.translatize.com/v1",
                "TRANSLATIZE_APP_URL": "https://app.translatize.com"
            }
        }
    }
}

Environment variables

  • TRANSLATIZE_API_TOKEN required secret Translatize integration API token (an "mcni_..." string), bound to one project and branch. Create it under Project Settings -> Integrations at https://app.translatize.com.
  • TRANSLATIZE_API_URL API base URL including the /v1 segment. Defaults to https://api.translatize.com/v1.
  • TRANSLATIZE_APP_URL Web-app base URL used to build review links. Defaults to https://app.translatize.com.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Translatize integrations
  2. Packages
  3. Development
  4. Publishing

Translatize integrations

Client-side tooling for the Translatize integration API (the machine-token API authenticated with Authorization: Bearer mcni_...). This is an npm workspace root that is intentionally separate from the apps in the repo – it has the only package.json with workspaces, and the repo root stays package.json-free.

Packages

PackageDirectoryStatusWhat it is
@translatize/corecore/availableZero-dependency TypeScript SDK for the integration API (client + flatten/unflatten helpers). The shared foundation everything else builds on.
@translatize/clicli/availableCommand-line tool (translatize init/pull/push/status) built on @translatize/core. Syncs translations from CI with git-like branching.
@translatize/mcpmcp/availableModel Context Protocol server exposing the API to AI agents (Claude Code, Cursor, ...) over stdio, built on @translatize/core.
CI templates

Two ready-to-use CI integrations complement the packages. They shell out to the @translatize/cli (npx @translatize/cli ...) rather than being npm packages, so you consume them as workflow/pipeline config, not via npm install:

TemplateHomeWhat it is
GitHub Actiongithub.com/Translatize/sync-actionComposite action (translatize/sync-action) wrapping the CLI's pull/push/status for GitHub workflows.
GitLab CIgitlab.com/translatize/gitlabCI/CD Catalog component (templates/translatize.yml) plus copy-paste .gitlab-ci.yml jobs.

Development

cd integrations
npm install        # installs every workspace and hoists dev deps
npm run build      # builds each workspace that defines a build script
npm test           # runs each workspace's test suite

Requires Node.js >= 18.17 (native fetch, node:test).

Publishing

The @translatize/core, @translatize/cli, and @translatize/mcp packages are published to npm under the @translatize scope. Publishing is manual – nothing here publishes automatically. To cut a release, build first, then npm publish --access public from the individual package directory (or npm publish --workspaces).

Frequently asked questions

What is com.translatize/mcp?

Read, search, edit and branch Translatize translation labels and fill missing translations.

How do I install com.translatize/mcp?

It runs on your machine. In Claude Code: claude mcp add com-translatize-mcp -e 'TRANSLATIZE_API_TOKEN=<your translatize_api_token>' -e 'TRANSLATIZE_API_URL=https://api.translatize.com/v1' -e 'TRANSLATIZE_APP_URL=https://app.translatize.com' -- npx -y @translatize/mcp@0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.translatize/mcp need an API key?

Yes. It expects TRANSLATIZE_API_TOKEN, which you set in its configuration.

Is com.translatize/mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains com.translatize/mcp?

It is published by Translatize. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.