Skip to main content

XTM Cloud 25.6

  • XTM Cloud 25.6
  • XTM Agent
  • Using XTM MCP Server to connect your own agents to XTM Cloud

Using XTM MCP Server to connect your own agents to XTM Cloud

XTM Cloud includes XTM Agent, our AI agent. It can answer product-related questions and support users in many tasks, such as project prioritization and Linguist assignments. For details, see Working with XTM Agent. However, if you prefer, you can also use XTM MCP Server to connect your own agentic solutions to XTM Cloud.

XTM MCP Server creates connection between your agents and the XTM platform. Our MCP Server offers a “headless” localization experience in which interaction with XTM Cloud is conversational and declarative. Your end-users can use their natural language to communicate with your in-house AI agents, assistants, or chatbots and get things done in XTM Cloud. For example, they can:

  • search for projects, get project status overview, or assess project criticality.

  • manage workflows and users.

  • get information about Linguists.

  • identify the best Linguists for a specific workflow step and even assign them to the required workflow steps.

For details about its functionality, see the XTM MCP Server capabilities section below.

Prerequisites

These criteria must be met to use XTM MCP Server:

  • Public Cloud instances must be running XTM Cloud 25.6, package number 260423_1641 or a more recent version. To check your XTM Cloud version, see Checking your XTM Cloud version and package number.

    For Private Cloud instances, contact your account manager and XTM Support to check which package you need to update to.

    To request support

    Visit our Support Portal.

  • You must have a license to use the XTM Cloud API.

  • You must use an MCP host with support for:

    • a remote server (such as VS Code, Claude Desktop, Cursor, Windsurf, etc.).

    • API key authentication.

    • custom headers.

  • Users who will use your in-house agents via XTM MCP Server must have the XTM Cloud Product Manager role.

Limitations

XTM MCP Server currently supports up to 10 requests per second for each authentication token.

Due to authentication constraints, the XTM MCP Server is restricted to a limited set of agents. For details, contact XTM Support.

To request support

Visit our Support Portal.

For capability limitations, see the XTM MCP Server capabilities section below.

Connecting to XTM MCP Server

Follow the steps below to connect to XTM MCP Server:

  1. Contact XTM Support to ask for an integration key.

    To request support

    Visit our Support Portal.

  2. Generate an API key. To do so, use the Generate token API endpoint (for details, see Generate token in XTM Connect SDK – REST API documentation). In the request body, enter these details:

    • client: your XTM Cloud Company name.

    • password: password of the Product Manager user used for integration.

    • userId: ID of the Product Manager user used for integration. To find the user ID, you can log in to XTM Cloud as this user. Next, select your avatar or the user icon (if you have not selected your avatar) in the top right-hand corner of the screen. Finally, select Download my data. The user ID is mentioned in the downloaded Excel file.

    • integrationKey: the integration key you have received from XTM Support (as described in step 1).

    Request body:

    {
  "client": "string",
  "password": "string",
  "userId": "integer",
  "integrationKey": "string"
}

  3. Once you have your API key, call the XTM MCP Server at mcp.xtm.ai.

  4. Verify if your configuration is correct. To do so, in your selected AI tool chat box, prompt: "Get XTM system info". If the connection to XTM MCP Server has been set up correctly, the response you receive will contain the XTM Server version.

Example 1. Configuration for Cursor

In the mcp.json file, in the .cursor folder, add this snippet:

{
  "mcpServers": {
    "XTM": {
      "url": "https://mcp.xtm.ai/mcp",
      "headers": {
        "Authorization": XTM-Basic <API Key>,
        "X-XTM-System-URL": <server_URL>,
      }
    }
  }
}

Important

Replace the <API Key> with the API key generated as described in step 2.

Replace the <server_URL> with your XTM Cloud production server URL.

Next, verify the Cursor configuration.

Verification_of_XTM_MCP_Server_connection.png

Information received in response to the "Get XTM system info" prompt if the connection has been successful.


XTM MCP Server capabilities

Note

After a successful connection, XTM MCP Server will pass information about available tools and limitations to your in-house agentic solutions.

Information in this section is meant for your end-users, who are interacting with your in-house agentic solutions, so that they have a better understanding of actions they can perform within XTM Cloud.

Users with the XTM Cloud Project Manager role can use XTM MCP Server to perform these tasks:

  • Project-related actions:

    • Search for projects by name, status, dates, creator, Project Manager, or customer for whom they have been created.

    • Check full project details, which include project languages, word counts, due dates, and customer information.

    • Check translation progress for specific projects, such as their job statuses, workflow steps, and due dates.

    • View project workflow configuration: steps, workflow transition types (also known as blocking types), and due date ranges.

  • User management:

    • List all users in your XTM Cloud instance.

    • List all users with the Linguist role in your XTM Cloud instance.

    • Check a Linguist's language pairs and access rights to a workflow step, subject matter, and a customer.

    • Find the best Linguist for a job based on their current workload.

  • Assignment management:

    • View current assignments in a project.

    • Assign Linguists to a project.

    • Unassign Linguists from a project.

    • Override current Linguist assignment (replace a currently assigned Linguist with a different one without unassigning them first).

  • Connectivity verification:

    • Check XTM Cloud version.

    • Check server information.

Important information:

  • Unless you specify a project name, ID, or date range, the search is limited to projects created in the last 14 days.

  • By default, only active and auto-archived projects are returned. To include archived or inactive projects, ask for them explicitly.

  • You don't need to specify an exact project name; partial matching is supported.

  • If you have a project's ID, its details can be fetched regardless of the project status.

  • When you assign a Linguist, the server validates their language pair compatibility and required access rights automatically.

Limitations:

  • It is not possible to assign Linguists to projects that are still being analyzed or have been archived, auto-archived, or deleted.

  • It is not yet possible to suggest or assign user groups or LSPs.

  • It is not yet possible to assign Linguists to bundles in a project. They can only be assigned to jobs and workflow steps.

In this section: