# Lokalise — how to use (mcp.ai)

Connect your Lokalise account and use 10 tools for project management straight from your AI agent. Connect with your own API key. Lokalise is a translation and localization management platform for managing multilingual content, projects, contributors, files, keys, translations, and localization workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_lokalise?ms=1787293620000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `lokalise_create_keys`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/lokalise`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/lokalise/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/lokalise/create/keys` — Create 1 to 500 keys in a Lokalise project or branch. Requires a personal read/write API token and the project's Manage keys admin right. Branch targets also require a compatible Software project with
  - body: { keys: object[], project_id: string, branch_name?: string, use_automations?: boolean }
- `POST https://api.mcp.ai/api/lokalise/delete/keys` — Permanently delete one or more keys from a Lokalise project or branch. This operation is irreversible and requires a personal read/write API token with key-management permission. Branch targets additi
  - body: { key_ids: string[], project_id: string, branch_name?: string }
- `POST https://api.mcp.ai/api/lokalise/list/audit/logs` — List one page of team audit events in OCSF 1.3.0 format. This endpoint requires a personal API token belonging to a team admin and a Lokalise plan that includes Audit Logs; availability was verified o
  - body: { limit?: integer, date_to?: string, user_id?: integer, date_from?: string, event_type?: string, project_id?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/lokalise/list/branches` — List one page of branches for a Lokalise project. This capability requires a Software project with Branching enabled; it is unavailable for other project types or projects with Branching disabled.
  - body: { limit?: integer, project_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/lokalise/list/keys` — Search and return one cursor page of keys from a Lokalise project or branch. Translation, comment, and screenshot expansion is opt-in to keep responses small. Branch access requires a branch-enabled S
  - body: { tags?: string[], limit?: integer, key_ids?: integer[], archived?: string, filenames?: string[], key_names?: string[], platforms?: string[], qa_issues?: string[], project_id: string, branch_name?: string, next_cursor?: string, include_comments?: boolean, untranslated_only?: boolean, disable_references?: boolean, include_screenshots?: boolean, include_translations?: boolean, translation_language_ids?: integer[] }
- `POST https://api.mcp.ai/api/lokalise/list/project/languages` — List one page of languages configured for a Lokalise project or, when branch_name is supplied, for a branch. Branch access requires a compatible Software project with Branching enabled.
  - body: { limit?: integer, project_id: string, branch_name?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/lokalise/list/projects` — List projects available to the connected Lokalise API token, optionally filtered by team or exact project names. Include settings to discover whether a Software project has Branching enabled.
  - body: { limit?: integer, team_id?: integer, next_cursor?: string, project_names?: string[], include_settings?: boolean, include_statistics?: boolean }
- `POST https://api.mcp.ai/api/lokalise/list/translations` — Search and return one cursor page of translations from a Lokalise project or branch by language, review state, task, or QA issue. Branch access requires a branch-enabled Software project.
  - body: { limit?: integer, qa_issues?: string[], project_id: string, branch_name?: string, is_reviewed?: boolean, language_id?: integer, next_cursor?: string, is_unverified?: boolean, active_task_id?: integer, is_untranslated?: boolean, disable_references?: boolean }
- `POST https://api.mcp.ai/api/lokalise/update/keys` — Batch update keys and their translations, including key metadata, translation content, review flags, and custom statuses, in one Lokalise project or branch. Requires a personal read/write API token an
  - body: { keys: object[], project_id: string, branch_name?: string, use_automations?: boolean }
- `POST https://api.mcp.ai/api/lokalise/update/translation` — Update one translation's content and review or status flags in a Lokalise project or branch. Requires a personal read/write API token; a read-only token cannot perform this action. Branch targets addi
  - body: { project_id: string, branch_name?: string, is_reviewed?: boolean, translation: string|object, is_unverified?: boolean, translation_id: integer, custom_translation_status_ids?: string[] }

## Example prompts
- "What can I do in Lokalise?"
- "Show me a summary of my Lokalise account"

## More
- Page: https://mcp.ai/lokalise
- Agent spec (llms.txt): https://mcp.ai/lokalise/llms.txt
- Postman collection: https://mcp.ai/lokalise/postman.json