Phrase MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Phrase MCP or direct API to manage projects, query locales and keys, update translations, and automate localization jobs through natural language.

Phrase logoPhrase
Api Key

Phrase is a software localization platform for managing projects, locales, keys, translations, and files. It helps teams automate translation workflows and ship multilingual products faster.

302 Tools

Try Phrase now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Phrase
Try asking
TOOLS

Supported Tools

Every Phrase action and event your agent gets out of the box.

List automation events for an account

Returns the run history across all automations in the account, newest-first.

List locales used in account

List all locales unique by locale code used across all projects within an account.

Get a single account

Get details on a single account.

Create an authorization

Create a new authorization.

Delete an authorization

Delete an existing authorization.

Get a single authorization

Get details on a single authorization.

List authorizations

List all your authorizations.

Update an authorization

Update an existing authorization.

Activate an automation

Activate an automation.

Create an automation

Create a new automation.

Deactivate an automation

Deactivate an automation.

Destroy automation

Destroy an automation of an account.

List events for an automation

Returns the run history for a specific automation, newest-first.

Get a single automation

Get details of a single automation.

List automations

List all automations for an account.

Trigger an automation

Trigger an automation.

Update an automation

Update an existing automation.

Create a blocked key

Create a new blocked-key rule.

Delete a blocked key

Delete an existing blocked-key rule.

Get a blocked key

Get a single blocked-key rule.

List blocked keys

List all blocked-key rules for the given project.

Update a blocked key

Update an existing blocked-key rule.

Compare branches

Compare branch with main branch.

Create comparison (async.)

Create a branch comparison asynchronously.

Create a branch

Create a new branch.

Delete a branch

Delete an existing branch.

List branches

List all branches of the current project.

Merge a branch

Merge an existing branch back into its base branch.

Get a single branch

Get details on a single branch for a given project.

Sync a branch

Pull changes from the base branch into this branch, applying the chosen conflict-resolution strategy.

Update a branch

Update an existing branch.

Dismiss a check issue

**Note:** The Checks API is still in development and might change in subsequent releases.

List check issues

**Note:** The Checks API is still in development and might change in subsequent releases.

Create a comment

Create a new comment for a key.

Delete a comment

Delete an existing comment.

Check if comment is read

Check if comment was marked as read.

Mark a comment as read

Mark a comment as read.

Mark a comment as unread

Mark a comment as unread.

Get a single comment

Get details on a single comment.

List comments

List all comments for a key.

Update a comment

Update an existing comment.

Create Key

Create a translation key in a Phrase Strings project with the documented key attributes, optionally including default-locale content.

Create Locale

Add a locale to a Phrase Strings project using a unique locale-style name and an ISO locale code.

Create Project

Create a Phrase Strings localization project in an accessible account.

Create Translation

Create content for one key and locale in a Phrase Strings project.

Destroy property

Destroy a custom metadata property of an account.

List properties

List all custom metadata properties for an account.

Create a property

Create a new custom metadata property.

Get a single property

Get details of a single custom property.

Update a property

Update an existing custom metadata property.

Delete Key

Delete an existing Phrase Strings key from a project or project branch.

Delete Locale

Delete an explicitly selected locale from a Phrase Strings project or project branch.

Delete Project

Delete an explicitly selected Phrase Strings project.

Create a distribution

Create a new distribution.

Delete a distribution

Delete an existing distribution.

Get a single distribution

Get details on a single distribution.

List distributions

List all distributions for the given account.

Update a distribution

Update an existing distribution.

Delete document

Permanently deletes a document and all of its associated translation segments from the project.

List documents

Returns all documents in a project that the authenticated user has read access to.

Attach the Figma attachment to a key

Attach the Figma attachment to a key

Create a Figma attachment

Create a new Figma attachment.

Delete a Figma attachment

Delete an existing Figma attachment.

Detach the Figma attachment from a key

Detach the Figma attachment from a key

Get a single Figma attachment

Get details on a single Figma attachment for a given project.

List Figma attachments

List all Figma attachments for the given project

Update a Figma attachment

Update an existing Figma attachment.

List formats

Returns all file formats that Phrase Strings supports.

Get Current User

Return the Phrase Strings user represented by the connected access token.

List term bases

List all term bases (previously: glossaries) the current user has access to.

Create a term base

Create a new term base (previously: glossary).

Delete a term base

Delete an existing term base (previously: glossary).

Get a single term base

Get details on a single term base (previously: glossary).

Create a term

Create a new term in a term base (previously: glossary).

Delete a term

Delete an existing term in a term base (previously: glossary).

Get a single term

Get details for a single term in the term base (previously: glossary).

List terms

List all terms in term bases (previously: glossary) that the current user has access to.

Create a translation for a term

Create a new translation for a term in a term base (previously: glossary).

Delete a translation for a term

Delete an existing translation of a term in a term base (previously: glossary).

Update a translation for a term

Update an existing translation for a term in a term base (previously: glossary).

Update a term

Update an existing term in a term base (previously: glossary).

Update a term base

Update an existing term base (previously: glossary).

Build ICU skeletons

Generates ICU (International Components for Unicode) message format skeletons for a given source string across one or more locales.

Create a new invitation

Invite a person to an account.

Delete an invitation

Delete an existing invitation (must not be accepted yet).

Resend an invitation

Resend the invitation email (must not be accepted yet).

Get a single invitation

Get details on a single invitation.

List invitations

List invitations for an account.

Update an invitation

Update an existing invitation (must not be accepted yet).

Update a member's invitation access

Update member's settings in the invitations.

Delete a job annotation

Delete an annotation for a job.

List job annotations

Retrieve a list of annotations for a job.

Create/Update a job annotation

Create or update an annotation for a job.

Create a job comment

Create a new comment for a job.

Delete a job comment

Delete an existing job comment.

Get a single job comment

Get details on a single job comment.

List job comments

List all comments for a job.

Update a job comment

Update an existing job comment.

Complete a job

Mark a job as completed.

Create a job

Create a new job.

Delete a job

Delete an existing job.

Add keys to job

Add multiple keys to a existing job.

Remove keys from job

Remove multiple keys from existing job.

Delete a job locale annotation

Delete an annotation for a job locale.

List job locale annotations

Retrieve a list of annotations for a job locale.

Create/Update a job locale annotation

Create or update an annotation for a job locale.

Complete a job locale

Mark a job locale as completed.

Review a job locale

Mark job locale as reviewed.

Remove a target locale from a job

Removes a target locale from a job.

Reopen a job locale

Mark a job locale as uncompleted.

Add a target locale to a job

Adds a target locale to a job.

Show single job target locale

Get a single target locale for a given job.

List job target locales

List all target locales for a given job.

Update a job target locale

Update an existing job target locale.

Lock a job

If you are the job owner, you may lock a job using this API request.

Reopen a job

Mark a job as uncompleted.

List account jobs

List all jobs for the given account.

Get a single job

Get details on a single job for a given project.

List jobs

List all jobs for the given project.

Start a job

Starts an existing job in state draft.

Create a job template

Create a new job template.

Delete a job template

Delete an existing job template.

Delete a job template locale

Delete an existing job template locale.

Create a job template locale

Create a new job template locale.

Get a single job template locale

Get a single job template locale for a given job template.

List job template locales

List all job template locales for a given job template.

Update a job template locale

Update an existing job template locale.

List job templates

List all job templates for the given project.

Get a single job template

Get details on a single job template for a given project.

Update a job template

Update an existing job template.

Unlock a job

If you are the job owner, you may unlock a locked job using this API request.

Update a job

Update an existing job.

List format annotations for a key

Returns the format annotations stored on a translation key.

Batch unlink child keys from a parent key

Removes one or more child keys from a parent key's linked-key group, or dissolves the entire group by setting unlink_parent to true.

Link child keys to a parent key

Designates a translation key as a parent and links one or more child keys to it.

Unlink a child key from a parent key

Removes a single child key from a parent key's link group.

List child keys of a parent key

Returns the key link record for a parent key, including all child keys associated with it.

Delete collection of keys

Delete all keys matching query.

Exclude a locale on a collection of keys

Exclude a locale on keys matching query.

Get a single key

Get details on a single key for a given project.

Include a locale on a collection of keys

Include a locale on keys matching query.

List keys

List all keys for the given project.

Add tags to collection of keys

Tags all keys matching query.

Remove tags from collection of keys

Removes specified tags from keys matching query.

List supported languages

Returns all languages/locale codes that Phrase Strings recognizes, mapped to their human-readable display name.

List Accounts

List Phrase Strings accounts available to the connected user and return account IDs for project creation and filtering.

List Locales

List or filter locales in a Phrase Strings project and return locale IDs used by translation actions.

List Projects

List or search Phrase Strings projects available to the connected user, optionally within one account or limited to favorites.

Download a locale

Download a locale in a specific file format.

Initiate async download of a locale

Prepare a locale for download in a specific file format.

Show status of an async locale download

Show status of already started async locale download.

Get a single locale

Get details on a single locale for a given project.

Update a locale

Update an existing locale.

Create a locale provider mapping

Creates a locale-pair-specific machine translation provider override for the account.

Delete a locale provider mapping

Removes the machine translation provider override for the specified source and target locale pair.

Get machine translation settings

Returns the machine translation configuration for the account, including the default translation service, current machine translation unit usage, and any locale-pair-specific provider mappings.

Update machine translation settings

Sets the default machine translation service for the account.

Remove a user from the account

Remove a user from the account.

List project members

Get all members active in the project.

Get single member

Get details on a single user in the account.

List members

Get all users active in the account.

Update a member

Update user permissions in the account.

Update a member's project settings

Update user settings in the project.

List notification groups

List all notification groups from the current user

Mark all notification groups as read

Mark all notification groups of the current user as read

Mark a notification group as read

Mark a notifications group of the current user as read

List notifications

List all notifications from the current user

Mark all notifications as read

Mark all notifications of the current user as read

Get a single notification

Get details on a single notification.

Confirm an order

Confirm an existing order and send it to the provider for translation.

Create a new order

Create a new order.

Cancel an order

Cancel an existing order.

Get a single order

Get details on a single order.

List orders

List all orders for the given project.

Create an organization job template

Create a new organization job template.

Delete an organization job template

Delete an existing organization job template.

Delete an organization job template locale

Delete an existing organization job template locale.

Create an organization job template locale

Create a new organization job template locale.

Get a single organization job template locale

Get a single job template locale for a given organization job template.

List organization job template locales

List all job template locales for a given organization job template.

Update an organization job template locale

Update an existing organization job template locale.

List organization job templates

List all job templates for the given account.

Get a single organization job template

Get details on a single organization job template for a given account.

Update an organization job template

Update an existing organization job template.

Create a pre-translation job

Triggers a pre-translation job for a resource within a project, addressed by `translatable_type` (`locale`, `job`, `translation_key`, or `upload`) and `translatable_id` (its ID).

Get a single pre-translation job

Returns a single pre-translation job identified by its ID.

List pre-translation jobs

Returns all pre-translation jobs scoped to a project, ordered by creation date descending.

Get a single project

Get details on a single project.

Update a project

Update an existing project, including its review workflow, pre-translation/autotranslate rules, and machine-translation configuration (see workflow, machine_translation_enabled, and the autotranslate_* fields below).

Get Translation Quality

Retrieves the quality scores for your Strings translations.

Create a reaction

Create a new reaction for a comment.

Delete a reaction

Delete an existing reaction.

Get a single reaction

Get details on a single reaction.

List reactions

List all reactions for a comment.

Create a release

Create a new release.

Delete a release

Delete an existing release.

Publish a release

Publish a release for production.

Get a single release

Get details on a single release.

List releases

List all releases for the given distribution.

Create a release trigger

Create a new recurring release.

Delete a single release trigger

Delete a single release trigger.

List release triggers

List all release triggers for the given distribution.

Get a single release trigger

Get details of a single release trigger.

Update a release trigger

Update a recurring release.

Update a release

Update an existing release.

List replies

List all replies for a comment.

Create a reply

Create a new reply for a comment.

Delete a reply

Delete an existing reply.

Mark a reply as read

Mark a reply as read.

Mark a reply as unread

Mark a reply as unread.

Get a single reply

Get details on a single reply.

List Locale Reports (word count, character count, translation statistics)

List all locale reports for the given project.

Get Project Report

Get report of a single project.

Activate a Repo Sync

Activate a deactivated Repo Sync.

Create a Repo Sync

Create a new Repo Sync.

Deactivate a Repo Sync

Deactivate an active Repo Sync.

Repository Syncs History

Get the history of a single Repo Sync.

Get a single Repo Sync Event

Shows a single Repo Sync event.

Export to code repository

Export translations from Phrase Strings to repository provider according to the .phrase.yml file within the code repository.

Import from code repository

Import translations from repository provider to Phrase Strings according to the .phrase.yml file within the code repository.

Get Repo Syncs

Lists all Repo Syncs from an account

Get a single Repo Sync

Shows a single Repo Sync setting.

Update a repo sync

Update settings for an existing Repo Sync.

Create a screenshot

Creates a screenshot in a project to provide visual context for in-context translation.

Delete a screenshot

Permanently removes a screenshot and all its associated markers from the project.

Create a screenshot marker

Create a new screenshot marker.

Delete a screenshot marker

Delete an existing screenshot marker.

Get a single screenshot marker

Get details on a single screenshot marker for a given project.

List screenshot markers

List all screenshot markers for the given project.

Update a screenshot marker

Update an existing screenshot marker.

Get a single screenshot

Returns a single screenshot belonging to the specified project.

List screenshots

List all screenshots for the given project.

Update a screenshot

Update an existing screenshot.

Search across projects

Search for keys and translations in all account projects *Note: Search is limited to 10000 results and may not include recently updated data depending on the project sizes.*

Search Keys

Search translation keys in a Phrase Strings project by text or documented qualifiers such as name:, ids:, tags:, or translated:.

Search Translations

Search translations in a Phrase Strings project and return each match with its key and locale context.

Create a Space

Create a new Space.

Delete Space

Delete the specified Space.

Get Space

Show the specified Space.

List Spaces

List all Spaces for the given account.

Add Project to Space

Adds an existing project to the space.

Remove Project from Space

Removes a specified project from the specified space.

List Projects in Space

List all projects for the specified Space.

Update Space

Update the specified Space.

Create a style guide

Create a new style guide.

Delete a style guide

Delete an existing style guide.

Get a single style guide

Get details on a single style guide.

List style guides

List all styleguides for the given project.

Update a style guide

Update an existing style guide.

Create a tag

Create a new tag.

Delete a tag

Delete an existing tag.

Get a single tag

Get details and progress information on a single tag for a given project.

List tags

List all tags for the given project.

Create a Team

Create a new Team.

Delete Team

Delete the specified Team.

Get Team

Show the specified Team.

List Teams

List all Teams for the given account.

Add Project to Team

Adds an existing project to the team.

Remove Project from Team

Removes a specified project from the specified team.

Add Space

Adds an existing space to the team.

Remove Space

Removes a specified space from the specified team.

Add User

Adds an existing user to the team.

Remove User

Removes a specified user from the specified team.

Update Team

Update the specified Team.

Exclude a translation from export

Set exclude from export flag on an existing translation.

Include a translation

Remove exclude from export flag from an existing translation.

Review a translation

Mark an existing translation as reviewed.

List translations by key

List translations for a specific key.

List translations by locale

List translations for a specific locale.

Exclude translations by query

Exclude translations matching query from locale export.

Get a single translation

Get details on a single translation.

Include translations by query

Include translations matching query in locale export.

List all translations

List translations for the given project.

Review translations selected by query

Review translations matching query.

Unreview translations selected by query

Unreview translations matching query.

Unverify translations by query

Mark translations matching query as unverified.

Verify translations by query

Verify translations matching query.

Unreview a translation

Mark a reviewed translation as translated.

Mark a translation as unverified

Mark an existing translation as unverified.

Verify a translation

Verify an existing translation.

Update Key

Update the documented attributes of one Phrase Strings translation key; omitted fields remain unchanged.

Update Translation

Update the content or reversible workflow state of one Phrase Strings translation.

Create upload batch

Groups multiple file uploads into a single batch.

Upload a new file

Upload a new language file.

Get a single upload

View details and summary for a single upload.

List uploads

List all uploads for the given project.

Create a variable

Create a new variable.

Delete a variable

Delete an existing variable.

Get a single variable

Get details on a single variable for a given project.

List variables

List all variables for the current project.

Update a variable

Update an existing variable.

Get a single version

Get details on a single version.

List all versions

List all changes done to a given translation.

Create a webhook

Create a webhook with an optional unique signing key used by the receiver to verify webhook signatures.

Delete a webhook

Delete an existing webhook.

List webhook deliveries

List all webhook deliveries for the given webhook_id.

Redeliver a single webhook delivery

Trigger an individual webhook delivery to be redelivered.

Get a single webhook delivery

Get all information about a single webhook delivery for the given ID.

Get a single webhook

Get details on a single webhook.

List webhooks

List all webhooks for the given project.

Test a webhook

Perform a test request for a webhook.

Update a webhook

Update an existing webhook, optionally rotating its unique signing key used by the receiver to verify webhook signatures.

SETUP GUIDE

Connect Phrase MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["phrase"],
  mcp: true,
});
Create a session scoped to Phrase and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List untranslated keys in my Phrase project",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Phrase request
SETUP GUIDE

Connect Phrase API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["phrase"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Phrase
3

Run Phrase tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List untranslated keys in my Phrase project" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Phrase tool calls through the session, and print the final answer

Why Use Composio?

AI Native Phrase Integration

  • Supports both Phrase MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying Phrase projects, locales, keys, translations, files, and jobs

Managed Auth

  • Securely stores your Phrase API keys instead of exposing them in agent prompts or application code
  • Central place to manage, scope, and revoke Phrase access
  • Per user and per environment credentials help keep localization data separated

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Natural-language requests can drive multi-step Phrase workflows such as finding untranslated keys and creating jobs
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC helps control which agents and users can access Phrase
  • Scoped, least privilege access to Phrase resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Phrase with any AI Agent Framework

Choose a Framework you want to connect Phrase with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Phrase.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Phrase tool your agent needs.Free to start.

Start building