com.translatize/mcp
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).
@translatize/mcpclaude 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
{
"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_TOKENrequired 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_URLAPI base URL including the /v1 segment. Defaults to https://api.translatize.com/v1.TRANSLATIZE_APP_URLWeb-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.
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
| Package | Directory | Status | What it is |
|---|---|---|---|
@translatize/core | core/ | available | Zero-dependency TypeScript SDK for the integration API (client + flatten/unflatten helpers). The shared foundation everything else builds on. |
@translatize/cli | cli/ | available | Command-line tool (translatize init/pull/push/status) built on @translatize/core. Syncs translations from CI with git-like branching. |
@translatize/mcp | mcp/ | available | Model 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:
| Template | Home | What it is |
|---|---|---|
| GitHub Action | github.com/Translatize/sync-action | Composite action (translatize/sync-action) wrapping the CLI's pull/push/status for GitHub workflows. |
| GitLab CI | gitlab.com/translatize/gitlab | CI/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.