Tolgee

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Your app's translations in Tolgee: search keys, create translations, trigger machine translation

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Tolgee": {
      "url": "https://app.tolgee.io/mcp/developer",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• get_batch_job_status

  Get the status of a batch job (e.g. machine translation) by its ID. Use to poll for completion.

  Parameters:

  • jobId (required) — number — ID of the batch job
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • keyNames (required) — array — Names of keys to translate
  • targetLanguageTags (required) — array — Language tags to translate into (e.g. ['de', 'fr'])
  • branch — string — Optional: branch name
  • namespace — string — Optional: namespace of the keys
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • relatedKeysInOrder (required) — array — List of related keys in the order they appear together
  • branch — string — Optional: branch name
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_branches

  List branches in a Tolgee project. Returns up to 100 results per page. Only available for projects with branching enabled (enterprise feature).

  Parameters:

  • page — number — Optional: page number (0-based, default 0)
  • search — string — Optional: search filter for branch names
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • name (required) — string — Name of the new branch
  • originBranchId (required) — number — ID of the branch to fork from
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • branchName (required) — string — Name of the branch to delete
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • page — number — Optional: page number (0-based, default 0)
  • branch — string — Optional: branch name
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • query (required) — string — Search query (matches key name or translation text)
  • page — number — Optional: page number (0-based, default 0)
  • branch — string — Optional: branch name
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)
  • languageTag — string — Optional: language tag to search translations in

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • keys (required) — array — List of keys to create
  • branch — string — Optional: branch name
  • namespace — string — Optional: default namespace for all keys (individual keys can override)
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_key

  Get a translation key's metadata (name, namespace, description) by its name. To get the key's translations, use get_translations.

  Parameters:

  • keyName (required) — string — The translation key name
  • branch — string — Optional: branch name
  • namespace — string — Optional: namespace of the key
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_key

  Update an existing translation key's name, namespace, or description

  Parameters:

  • keyName (required) — string — Current key name (used to find the key)
  • newName (required) — string — New key name (provide the current name if unchanged)
  • keyBranch — string — Optional: branch name (used to find the key, for branching projects)
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)
  • keyNamespace — string — Optional: current namespace of the key (used to find the key)
  • newNamespace — string — Optional: new namespace for the key
  • newDescription — string — Optional: new description for the key

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • keyNames (required) — array — Names of the keys to delete
  • branch — string — Optional: branch name
  • namespace — string — Optional: namespace of the keys
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_languages

  List all languages configured for a Tolgee project. Returns up to 1000 results per page.

  Parameters:

  • page — number — Optional: page number (0-based, default 0)
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_language

  Add a new language to a Tolgee project

  Parameters:

  • name (required) — string — Language display name (e.g. 'German')
  • tag (required) — string — Language tag / IETF BCP 47 code (e.g. 'de')
  • flagEmoji — string — Flag emoji for this language
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)
  • originalName — string — Native name of the language (e.g. 'Deutsch')

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_namespaces

  List all namespaces in a Tolgee project. Namespaces organize translation keys into logical groups (e.g. by feature, page, or module).

  Parameters:

  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_projects

  List Tolgee projects accessible to the current user. Returns up to 100 results per page.

  Parameters:

  • page — number — Optional: page number (0-based, default 0)
  • search — string — Optional search query to filter projects by name

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_project

  Create a new Tolgee project with initial languages

  Parameters:

  • name (required) — string — Project name
  • organizationId (required) — number — ID of the organization to create the project in
  • languages (required) — array — Initial languages for the project
  • baseLanguageTag — string — Tag of the base language (default: first language)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_tags

  List all tags used in a Tolgee project. Returns up to 1000 results per page.

  Parameters:

  • page — number — Optional: page number (0-based, default 0)
  • search — string — Optional: search filter for tag names
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tag_keys

  Add tags to translation keys. Creates tags if they don't exist.

  Parameters:

  • keyNames (required) — array — Names of the keys to tag
  • tags (required) — array — Names of the tags to add
  • branch — string — Optional: branch name
  • namespace — string — Optional: namespace of the keys
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • keyName (required) — string — The translation key name
  • branch — string — Optional: branch name
  • languages — array — Optional: language tags to filter by (e.g. ['en', 'de']). If omitted, returns all languages.
  • namespace — string — Optional: namespace of the key
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • keyName (required) — string — The translation key name
  • translations (required) — object — Translations as {languageTag: text} map (e.g. {"en": "Hello", "de": "Hallo"})
  • branch — string — Optional: branch name
  • namespace — string — Optional: namespace of the key
  • projectId — number — ID of the project (required for PAT, auto-resolved for PAK)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.