Connect a development agent

Troevo exposes a remote Model Context Protocol (MCP) server for development agents. The server uses Troevo’s normal sign-in and organization access through OAuth 2.1. You do not need to create or copy an API key.

Connect

Add this remote MCP URL to your agent:

https://troevo.com/api/mcp

Your MCP client opens Troevo in the browser. Sign in, select the organization you want the agent to use, review the requested permission, and authorize it.

The agent receives permission to create namespaces, add translation keys, and save translation drafts in that organization. It cannot choose another organization by passing an organization ID.

Discover project context

Use get_project_context without arguments to list the projects available to the authorized organization. Pass projectSlug to also receive that project’s default locale, enabled locales, namespaces, namespace key counts, and current plan usage. This is the recommended first call when the agent does not already know the exact Troevo structure.

Inspect keys and translations

Use list_translation_keys with a project slug and namespace to inspect keys, descriptions, and which locales already have values. It returns at most 100 keys, accepts an optional query, and returns nextCursor when another page is available.

Use get_translations to read the values and review statuses for 1–100 named keys in one enabled locale:

{
  "projectSlug": "web-app",
  "namespace": "checkout",
  "locale": "fi",
  "keys": ["checkout.submit", "checkout.cancel"]
}

These tools are read-only and remain scoped to the organization selected during authorization.

Create a namespace

Ask the agent to use create_namespace with the project slug and a lowercase namespace name. Creating the same namespace more than once is safe: Troevo returns the existing namespace.

Add translation keys

Ask the agent to use add_translation_keys. One call accepts 1–100 keys for a single project and namespace:

{
  "projectSlug": "web-app",
  "namespace": "checkout",
  "keys": [
    { "key": "checkout.submit", "description": "Checkout submit button" },
    { "key": "checkout.cancel" }
  ]
}

The response preserves the input order and marks each key as created or existing. The whole batch is atomic: duplicate or invalid input, or exceeding your plan’s translation-key limit, creates nothing.

Save translation drafts

Use upsert_translations to save 1–100 values for one enabled locale:

{
  "projectSlug": "web-app",
  "namespace": "checkout",
  "locale": "fi",
  "translations": [
    { "key": "checkout.submit", "value": "Maksa" },
    { "key": "checkout.cancel", "value": "Peruuta" }
  ]
}

The response preserves the input order and marks each value as inserted, updated, or unchanged. Troevo records history for changed values and marks every inserted or updated value as Needs review. If any key or value is invalid, the entire batch is rejected. The agent cannot approve or publish through this tool.

Generate translation drafts

Use generate_translation_drafts with 1–100 existing keys in one namespace and one target locale:

{
  "projectSlug": "web-app",
  "namespace": "checkout",
  "targetLocale": "fi",
  "keys": ["checkout.submit", "checkout.cancel"],
  "force": false
}

Troevo translates from the project’s default locale using the project description and key context. By default, only missing target values are generated; existing values are returned with existing status. Set force to true to regenerate every requested key. Provider errors, missing source values, or incomplete output save nothing.

AI translation requires an active subscription and is rate-limited. Generated translations are marked as Needs review and are never approved or published automatically.

Revoke access

Agent access is linked to your Troevo user and organization membership. Removing the user from the organization prevents the agent from making further changes.