create_branch
Create a new branch in a Tolgee project by forking from an existing branch. Only available for projects with branching enabled (enterprise feature).
LABSCO SUMMARY
store_big_meta is the tool that separates competent machine translation from embarrassing machine translation.
Translating a UI string in isolation is how you get a button labelled with the wrong sense of a word — "Post" as mail rather than publish. Telling the platform which keys sit next to each other gives the translation engine the surrounding context a human translator would have had. It is unglamorous and it is the single biggest quality lever here. Note also that their destructive tools say so in their own descriptions and ask the assistant to confirm first — the warning is delivered where it can actually take effect.
What it is
Tolgee is a localisation platform. Its endpoint covers the day-to-day work: keys, languages, namespaces, and machine translation as a job you poll.
What you get
- Keys — list, search by name or translation text, create with translations and tags, get, update, delete
- Languages and namespaces, plus per-language translation progress statistics
- Machine translation started as a batch job, with status polling
- store_big_meta — record how keys relate so translations of neighbouring keys become context for the machine translation
- Branches — list, create by forking, delete, on projects that have them
- Projects — list and create, the latter needing an account-wide token
Requirements
A project API key or a personal access token as a header. Self-hosted instances expose the same path on your own domain. Their suggested first move is a read-only call to confirm the connection.
Setup effort
Paste a URL with a key — add the endpoint to your client
USE CASES
01
Adding strings from where you wrote them
Create keys with their translations and tags in one call.
02
Finding the string you mean
Search by key name or by the translated text itself.
03
Getting a language translated
Start machine translation as a job, then poll it.
04
Improving the machine output
Record key relationships so neighbouring strings become context.
05
Checking how far along you are
Per-language progress statistics for the project.
22 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_keys
Create translation keys in a Tolgee project with optional translations and tags. Keys that already exist are silently skipped — their translations and tags are not updated. Use update_key and set_translation to modify existing keys.
create_language
Add a new language to a Tolgee project
create_project
Create a new Tolgee project with initial languages
delete_branch
Delete a branch from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.
delete_keys
Delete translation keys from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.
get_batch_job_status
Get the status of a batch job (e.g. machine translation) by its ID. Use to poll for completion.
get_key
Get a translation key's metadata (name, namespace, description) by its name. To get the key's translations, use get_translations.
get_project_language_statistics
Get translation status and progress for each language in a project. Returns per-language statistics including translated, reviewed, and untranslated percentages.
get_translations
Get translations for a specific key in a Tolgee project. Returns translations in all project languages, or only the specified languages if provided.
list_branches
List branches in a Tolgee project. Returns up to 100 results per page. Only available for projects with branching enabled (enterprise feature).
list_keys
List translation keys in a Tolgee project. Returns up to 100 keys per page. Use search_keys to find specific keys by name or translation text.
list_languages
List all languages configured for a Tolgee project. Returns up to 1000 results per page.
list_namespaces
List all namespaces in a Tolgee project. Namespaces organize translation keys into logical groups (e.g. by feature, page, or module).
list_projects
List Tolgee projects accessible to the current user. Returns up to 100 results per page.
list_tags
List all tags used in a Tolgee project. Returns up to 1000 results per page.
machine_translate
Start machine translation for specified keys into target languages. Returns a batch job ID — use get_batch_job_status to poll for completion.
search_keys
Search for translation keys in a Tolgee project by name or translation text. Returns up to 50 matching keys per page. Note: namespace and tags filtering is not yet supported — filter results client-side if needed.
set_translation
Set or update translations for a key in one or more languages. The key must already exist — use create_keys to create it first.
store_big_meta
Store key relationships so Tolgee can use translations of related keys as context during machine translation, producing more consistent results. Keys that appear near each other in source code (e.g. on the same page or component) should be stored as related.
tag_keys
Add tags to translation keys. Creates tags if they don't exist.
update_key
Update an existing translation key's name, namespace, or description
BEFORE YOU INSTALL
What to know first
Tools you get
22 tools when we connected.
Requires
- an MCP client that can reach a remote endpoint
- An X-API-Key header — a project key for one project, or a personal access token across the account
CONTEXT COST
Light Standing cost
Rated by the size of the 22 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the endpoint to your client.
Server setup
ENDPOINT URL
https://app.tolgee.io/mcp/developerRequirements
- An X-API-Key header — a project key for one project, or a personal access token across the account
