# SimpleLocalize — how to use (mcp.ai)

Connect your SimpleLocalize account and use 14 tools for developer tools straight from your AI agent. Connect with your own API key. SimpleLocalize is a translation management platform for managing localization keys, translations, languages, imports, exports, and hosted environments.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_simple_localize?ms=1787291160000`
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. `simple_localize_create_tag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/simple_localize`
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/simple_localize/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/simple_localize/create/tag` — Create a project tag for organizing translation keys.
  - body: { name: string, color?: string }
- `POST https://api.mcp.ai/api/simple_localize/create/translation/key` — Create one translation key and optional metadata in the connected project.
  - body: { key: string, lock?: boolean, tags?: string[], namespace?: string, attributes?: object, deprecated?: boolean, description?: string, characters_limit?: integer, code_description?: string }
- `POST https://api.mcp.ai/api/simple_localize/create/translation/keys` — Create up to 100 translation keys and report every rejected entry; valid entries may still be created when others fail.
  - body: { translation_keys: object[] }
- `POST https://api.mcp.ai/api/simple_localize/delete/tag` — Permanently delete one project tag by its exact name. This destructive action cannot be undone.
  - body: { tag_name: string }
- `POST https://api.mcp.ai/api/simple_localize/delete/translation/key` — Permanently delete one translation key, including all translations attached to it, by exact key and namespace. WARNING: This destructive action cannot be undone.
  - body: { key: string, namespace?: string }
- `POST https://api.mcp.ai/api/simple_localize/export/translations` — Create downloadable snapshot URLs for project translations in a selected file format. Returns URLs without downloading file bytes.
  - body: { sort?: string, tags?: string[], customer_id?: string, language_keys?: string[], language_order?: string[], download_format: string, download_options?: string[] }
- `POST https://api.mcp.ai/api/simple_localize/get/project/context` — Return the connected project and its current languages, tags, and hosting environments so an agent can choose valid identifiers before managing translations.
- `POST https://api.mcp.ai/api/simple_localize/get/translation/key` — Return full metadata for one translation key selected by key and namespace.
  - body: { key: string, namespace?: string }
- `POST https://api.mcp.ai/api/simple_localize/list/activity` — Return a manually selected page of recent project changes for operational visibility.
  - body: { page?: integer, size?: integer }
- `POST https://api.mcp.ai/api/simple_localize/list/file/formats` — Return the file formats currently accepted by SimpleLocalize exports, including multi-language, beta, and deprecation metadata.
- `POST https://api.mcp.ai/api/simple_localize/list/translation/keys` — Search translation keys and return one controllable page of provider summary fields. Use Get Translation Key for detailed metadata such as tags.
  - body: { key?: string, size?: integer, sort?: string, namespace?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/simple_localize/list/translations` — Search translations by key, language, text, review state, or namespace and return one page.
  - body: { key?: string, size?: integer, text?: string, query?: string, sort_by?: string, language?: string, base_only?: boolean, namespace?: string, sort_order?: string, customer_id?: string, next_cursor?: string, text_status?: string, review_status?: string }
- `POST https://api.mcp.ai/api/simple_localize/set/translation` — Set the text and optional review state for one existing translation key and language.
  - body: { key: string, text: string, language: string, namespace?: string, customer_id?: string, review_status?: string }
- `POST https://api.mcp.ai/api/simple_localize/set/translations` — Set 1 to 100 translations in one request. Reports each rejected entry and distinguishes complete success from partial success.
  - body: { translations: object[] }

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

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