}

Authentication

The MCP server supports two authentication methods:

OAuth 2.0 (recommended): used automatically by Claude Desktop, Cursor, and other MCP clients that support it. No manual token management needed. The OAuth flow creates a Personal Access Token in your profile automatically. Access can be revoked at any time.

Personal Access Token (PAT): for CI/CD, scripts, or clients that don't support OAuth. Create one in your profile under Personal Access Tokens. Pass it as Authorization: Bearer lz_pat_.... See the PAT documentation for details on scopes and security.

Available tools

The MCP server exposes 22 tools organized by workflow:

Discovery

Tool	Description
`list_projects`	List all projects accessible via your token. Call this first.
`get_project_stats`	Translation coverage per version, language, and namespace
`list_branches`	List branch projects of a parent project
`list_tenants`	List tenant projects of a parent project

Translation content

Tool	Description
`get_translations`	Fetch unpublished (editor state) translations with filtering by tags, timestamps, and pagination
`get_published_translations`	Fetch published (CDN) translations for a namespace
`find_missing_translations`	Compare a target language against the reference language; returns missing and stale keys
`report_missing_keys`	Add new keys (never overwrites existing). Auto-batches at 1000 keys. If Automatic Translation is enabled, new keys on the reference language are translated into all target languages automatically.
`update_translations`	Update or delete translation keys. Set a value to `null` to delete.

Release workflow

Tool	Description
`publish_version`	Publish a version to the CDN. Returns a jobId for status tracking.
`copy_version`	Copy all translations from one version to another (e.g. latest → production)
`copy_language`	Copy a single language between versions
`get_job_status`	Check or wait for async operations (publish, copy, merge) to complete

Branch workflow

Tool	Description
`create_branch`	Create a translation branch from a version
`merge_branch`	Merge a branch back into its parent project

Locize

Tools

Server Config