SimpleLocalize integration
SimpleLocalize is a translation management platform for software localization. Manage a project's translation keys (single and bulk create, update, delete, screenshots), read and update translations, import and export translation files in 20 formats, start machine or AI auto-translation jobs and translate a single text, manage languages, tags, per-customer translations, glossary entries, suggestions and hosting environments, publish translations to the CDN, and read project activity. Authentication is the project's API key in the X-SimpleLocalize-Token header (Settings, Credentials, API Key), so each credential reaches one project. Routes that need a personal access token instead (listing and creating projects, project contributors, project access, comments) and the custom hosting route that stores cloud storage secrets are not exposed. Rate limits: 60 requests per minute per IP and 300 per project; publication 10 per minute per project.
Say what should happen.
The workflow builds itself.
What you can do with SimpleLocalize
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Translation key, 6 operations
create_translation_keyCreate translation keyPOSTCreates a translation key; fails if it already exists. Optional namespace (default namespace when left out), description, codeDescription, charactersLimit (-1 or left out: no limit), lock, deprecated, tags.delete_translation_keyDelete translation keyDELETEDeletes one translation key and its translations, identified by key and namespace.delete_translation_key_by_idDelete translation key by idDELETEDeletes a translation key by its id (from list_all_translation_key_ids). Fails if it does not exist.list_translation_keysList translation keysGETLists translation keys with metadata (description, tags, limits, lock, timestamps), filtered by exact key or namespace. Page size default 100, at most 2500; pages from 0.update_translation_keyUpdate translation keyPATCHUpdates a translation key's metadata, found by key and namespace. Fails if the key does not exist. To rename a key or move it to another namespace use update_translation_key_by_id.update_translation_key_by_idUpdate translation key by idPATCHRenames a translation key, moves it to another namespace, or updates its descriptions and metadata, by id. Empty values are ignored. Fails if the new key and namespace pair exists.
Customer, 5 operations
create_customerCreate customerPOSTCreates a customer for per-customer translations (Business plan).delete_customerDelete customerDELETEDeletes a customer by key.get_customerGet customerGETReturns one customer by key: key, display name and description.list_customersList customersGETLists the project's customers (per-customer translation variants, Business plan) with key, display name and description.update_customerUpdate customerPATCHUpdates a customer's key, display name or description. Leave out a field to keep it.
Language, 5 operations
create_languageCreate languagePOSTAdds a language to the project.delete_languageDelete languageDELETERemoves a language from the project by key.get_languageGet languageGETReturns one project language by key.list_languagesList languagesGETLists the project's languages with their keys and names.update_languageUpdate languagePATCHUpdates a project language's key or name. Leave out a field to keep it.
Bulk, 4 operations
create_translation_key_bulkCreate translation key bulkPOSTCreates up to 100 translation keys in one request. Keys that already exist do not fail the call; they are returned in failures.delete_translation_key_bulkDelete translation key bulkDELETEDeletes up to 100 translation keys in one request. Keys that do not exist do not fail the call; they are returned in failures.update_translations_bulkUpdate translations bulkPATCHUpdates up to 100 translations in one request. Failed updates are returned in failures with a message; the rest are applied.upload_screenshot_for_keysUpload screenshot for keysPOSTAttaches one base64 screenshot to several translation keys at once.
Tag, 4 operations
create_tagCreate tagPOSTCreates a tag; fails if it already exists. name: 2 to 16 letters, numbers, spaces, underscores, dashes or dots. color: a hex code without #, for example FF5733.delete_tagDelete tagDELETEDeletes a tag from the project by name.list_tagsList tagsGETLists the project's tags with their name and color.update_tagUpdate tagPATCHRenames or recolors a tag; fails if the tag does not exist. Leave out a field to keep it.
Environment, 3 operations
create_environmentCreate environmentPOSTCreates a custom hosting environment to publish translations to. key must be unique, lowercase letters, numbers and dashes, and not _latest or _production.get_environment_statusGet environment statusGETReturns the hosting status of one environment: the published resources and their paths.list_environmentsList environmentsGETLists the project's hosting environments (_latest, _production and custom ones) with key, name, color and type.
Glossary, 3 operations
create_glossary_entryCreate glossary entryPOSTCreates a glossary entry, or updates the translations of the entry with the same sourceText. Languages must exist in the project. Not available on the Community plan.delete_glossary_entryDelete glossary entryDELETEDeletes a glossary entry with all its translations, matched by its source term.list_glossary_entriesList glossary entriesGETLists the project's glossary entries, sorted by source term, each with its source language, caseSensitive flag and translations per target language.
Auto translate, 2 operations
auto_translate_textAuto translate textPOSTMachine-translates one text with the chosen provider (Google Translate, DeepL, OpenAI, OpenRouter, custom AI, Anthropic or Gemini) and returns translatedText. Does not change the project.start_auto_translationStart auto translationPOSTStarts auto-translation jobs for the given project languages, using the settings of the last auto-translation. Consumes the plan's auto-translation quota. Returns job ids; follow them with get_job.
Job, 2 operations
get_jobGet jobGETReturns one job by id: progress, state, type, message and start time. Use it to follow start_auto_translation.list_jobsList jobsGETLists the project's background jobs (auto-translation and others) with progress, status, type and errors.
Suggestion, 2 operations
create_suggestionCreate suggestionPOSTSubmits a translation suggestion with an explanation for one translation key and language. Sent with the project API key, it is created only if the project accepts anonymous suggestions for that language.list_suggestionsList suggestionsGETLists translation suggestions for one translation key and language. Paginated from page 0.
Translation, 2 operations
list_translationsList translationsGETLists translations, filtered by key, namespace, language, text, review status or customer. text and query search with contains (3+ characters) and return at most 10. Paginated from page 0, default size 100.update_translationUpdate translationPATCHSets the text of one translation (key and language). reviewStatus left out marks the translation NOT_REVIEWED. Fails if the key, language or customer does not exist.
Activity, 1 operation
list_activityList activityGETLists the project's activity (imports, exports, publications, auto-translations, edits) with user, counts and environment. Up to the 500 latest entries; page size at most 50 (default 10), pages from 0.
Change, 1 operation
list_activity_changesList activity changesGETLists every change made by one activity entry from list_activity.
Description, 1 operation
update_translation_key_descriptionUpdate translation key descriptionPATCHSets the editor description of a translation key found by key and namespace. An empty or missing description clears it. Fails if the key does not exist.
Detail, 1 operation
get_translation_key_detailsGet translation key detailsGETReturns one translation key's details: description, code description, tags, limit, deprecation, attributes, screenshot URL and created and last-seen dates.
Export, 1 operation
export_translationsExport translationsGETExports translations to file(s) and returns download URLs (one per language or namespace when split options are set). Fetch the file from data.files[].url.
File format, 1 operation
list_file_formatsList file formatsGETLists the translation file formats SimpleLocalize supports, for uploadFormat of import_translations and downloadFormat of export_translations.
File upload, 1 operation
upload_translation_key_screenshot_fileUpload translation key screenshot filePOSTSets a translation key's screenshot from an image file (at most 4 MB). Replaces the key's existing screenshot. PNG, JPG or JPEG only.
Import, 1 operation
import_translationsImport translationsPOSTImports a translation file into the editor. By default only new translations are added and existing ones are kept; options change that. Returns the keys and languages found.
List, 1 operation
list_all_translation_key_idsList all translation key idsGETLists every translation key of the project with only its id, key and namespace, unpaginated. Use the id with update_translation_key_by_id or delete_translation_key_by_id.
Project, 1 operation
get_projectGet projectGETReturns the project's details: name, project token, languages, customers, namespaces, environments, key count, unpublished changes, translated percentage and hosting resources.
Publish, 1 operation
publish_translationsPublish translationsPOSTPublishes translations to a hosting environment on the CDN, where apps read them. Use _latest to publish from the editor, then _production to promote _latest. Limited to 10 calls per minute per project.
Screenshot, 1 operation
upload_translation_key_screenshotUpload translation key screenshotPOSTSets a translation key's screenshot from a base64 image (at most 2 MB). Replaces the key's existing screenshot. PNG, JPG or JPEG only.
Use SimpleLocalize from Claude Code, Cursor or Codex
Connect SimpleLocalize in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its SimpleLocalize operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect SimpleLocalize
- Create your workspace
Sign up free. Nothing to install.
- Connect SimpleLocalize once
Add your SimpleLocalize connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
SimpleLocalize integration FAQ
What can you do with the SimpleLocalize integration?
LiveContext exposes 50 operations on SimpleLocalize, covering translation key, customer, language and bulk.
