@phrase/phrase-mcp-server

[LEGACY] Fetch a single AI Check by its UID from Phrase Quality Evaluator. Returns name and qualityRequirements. Only available for early-access program users — in V3, rules are configured via Content Groups in the Phrase platform UI and cannot be managed through the API. (GET /v1/aiChecks/{uid})

[LEGACY] Fetch a single Quality Profile by its UID, including the AI Checks it contains. Only available for early-access program users — in V3, quality configuration is managed via Content Groups in the Phrase platform UI. Use bqe_get_quality_profile_v3 to read V3 profiles. (GET /v1/qualityProfiles/{uid})

[LEGACY] Update an existing Quality Profile in Phrase Quality Evaluator. Replaces both name and the list of AI Check UIDs. Only available for early-access program users — in V3, quality configuration is managed via Content Groups in the Phrase platform UI and there is no API write path for profiles. (PUT /v1/qualityProfiles/{uid})

[LEGACY] Delete an AI Check from Phrase Quality Evaluator. Also removes it from any Quality Profiles that reference it. Only available for early-access program users — in V3, rules are configured via Content Groups in the Phrase platform UI and cannot be managed through the API. (DELETE /v1/aiChecks/{uid})

Get details for a specific Phrase TMS termbase. (GET /api2/v1/termBases/{uid})

Start a draft job in a Phrase Strings project.

[LEGACY] Update an existing AI Check in Phrase Quality Evaluator. Replaces both name and qualityRequirements. Only available for early-access program users — in V3, rules are configured via Content Groups in the Phrase platform UI and cannot be managed through the API. (PUT /v1/aiChecks/{uid})

Evaluate the quality of translation segments using Phrase Quality Evaluator V3. Uses a Content Group ID to determine which AI Check rules to apply. Requires ADMIN or OWNER IDM role. (POST /v3/evaluation)

Fetch the quality profile (rules) for a Content Group from Phrase Quality Evaluator V3. Returns all rules configured in the Content Group, optionally filtered by locale. (GET /v3/qualityProfiles/{contentGroupId})

[LEGACY] Delete a Quality Profile in Phrase Quality Evaluator. AI Checks referenced by this profile are not deleted. Only available for early-access program users — in V3, quality configuration is managed via Content Groups in the Phrase platform UI and there is no API write path for profiles. (DELETE /v1/qualityProfiles/{uid})

[LEGACY] Create a new AI Check in Phrase Quality Evaluator. Requires ADMIN or OWNER IDM role. Only available for early-access program users — in V3, rules are configured via Content Groups in the Phrase platform UI and cannot be managed through the API. (POST /v1/aiChecks)

[LEGACY] Evaluate the quality of translation segments using Phrase Quality Evaluator. Provide either qualityProfileUid OR aiCheckUids (not both). Requires ADMIN or OWNER IDM role. Only available for early-access program users — new users should use bqe_evaluate_segments_v3 with a contentGroupId instead. (POST /v2/evaluation)

[LEGACY] Create a new Quality Profile in Phrase Quality Evaluator containing up to 3 AI Checks. Requires ADMIN or OWNER IDM role. Only available for early-access program users — in V3, quality configuration is managed via Content Groups in the Phrase platform UI and there is no API write path for profiles. (POST /v1/qualityProfiles)

Return aggregated evaluation analytics from Phrase Quality Evaluator for the supplied date range and optional Quality Profile filter. (GET /v1/analytics)

[LEGACY] List Quality Profiles for the authenticated organization in Phrase Quality Evaluator. A Quality Profile groups up to 3 AI Checks for reuse during evaluation. Only available for early-access program users — in V3, quality configuration is managed via Content Groups in the Phrase platform UI. Use bqe_get_quality_profile_v3 to read V3 profiles. (GET /v1/qualityProfiles)

[LEGACY] List all AI Checks for the authenticated organization in Phrase Quality Evaluator. AI Checks are reusable quality requirements written in natural language. Only available for early-access program users — in V3, rules are configured via Content Groups in the Phrase platform UI and cannot be managed through the API. (GET /v1/aiChecks)

List Google Drive content through the Connectors API. Pass request.connectorUuid plus request.configuration (usually {}). If request.path is omitted, the MCP wrapper lists the Google Drive navigation root with { pathType: 'ROOT' }.

Upload a local file to Google Drive through the Connectors API. Pass request.connectorUuid, request.configuration (usually {}), and request.path. Native Google Drive uploads want a FILE target path that includes the destination filename; as a convenience, this MCP wrapper also accepts a FOLDER path and rewrites it to a FILE target using request.name or the basename of file_path.

Download raw Google Drive content through the Connectors API. request must mirror the Bifrost Google Drive download-raw-file request body and use request.connectorUuid.

List Connectors API connectors. In v1, Phrase MCP supports only the google-drive connector for content operations.

Create a new Phrase TMS project from scratch. Requires Project Manager permissions. For most use cases, prefer tms_create_project_from_template_shorthand instead, which applies pre-configured settings. Use this only when no suitable template exists. (POST /api2/v3/projects)

Create a quote for translation work in Phrase TMS. Requires a price list, analysis, and project reference. Returns the created quote including total price, billing unit, currency, and status. (POST /api2/v1/quotes)

Change the status of a Phrase TMS project. Check current status with tms_get_project first. CANCELLED is irreversible. (POST /api2/v1/projects/{projectUid}/setStatus)

List all jobs in a Phrase TMS project. Returns job metadata including uid, filename, status, target language, word count, and due date. Use tms_search_jobs instead when filtering by multiple criteria simultaneously. (GET /api2/v2/projects/{projectUid}/jobs)

Fetch a quote by UID from Phrase TMS. Returns full quote details: name, status (NEW/DRAFT/FOR_APPROVAL/APPROVED/DECLINED), quoteType (BUYER/PROVIDER), totalPrice, currency, billingUnit, priceList, netRateScheme, provider, and workflowStepList. (GET /api2/v1/quotes/{quoteUid})

Upload/Import terms into a Phrase TMS termbase. Provide either file_path (host filesystem path, for local MCP server use) or file_content + file_name (base64-encoded file bytes, for Claude Desktop uploaded files).

Update an existing Phrase TMS project settings such as name, due date, or note. To change project status (e.g. mark Completed), use tms_set_project_status instead. (PUT /api2/v2/projects/{projectUid})

Recalculate one or more existing analyses in Phrase TMS. Returns async request objects. (POST /api2/v1/analyses/recalculate)

List translation memories in Phrase TMS. (GET /api2/v1/transMemories)

Search for jobs in a Phrase TMS project using structured filters. Prefer this over tms_list_jobs when filtering by multiple fields at once (e.g. status + target language + filename). Returns matching jobs with full metadata. (POST /api2/v1/projects/{projectUid}/jobs/search)

Get the Content Group linked to a TMS project. Returns the Content Group's id and name, or 404 if none is linked. (GET /api2/v1/projects/{projectUid}/contentGroup)

Fetch the analysis data for a specific job within an analysis in Phrase TMS. Returns word counts and match rates for that job. (GET /api2/v1/analyses/{analyseUid}/jobs/{jobUid})

Set or remove the net rate scheme for an analysis in Phrase TMS. Pass an empty object to remove. (PUT /api2/v1/analyses/{analyseUid}/netRateScheme)

Link a TMS project to a Content Group. Returns the linked Content Group. Returns 422 Unprocessable Entity if the project already has style guides assigned. (POST /api2/v1/projects/{projectUid}/contentGroup)

Delete a single analysis from Phrase TMS. Set purge=true to permanently delete instead of moving to trash. (DELETE /api2/v1/analyses/{analyseUid})

List all Phrase TMS projects you have access to. Use this to discover project UIDs before fetching job lists or project details. Returns an array of project objects, each containing uid, name, status, sourceLang, and targetLangs. (GET /api2/v1/projects)

Trigger an asynchronous quality evaluation for selected TMS job parts. Automatically selects the evaluation flow based on project configuration: uses the legacy Quality Profile flow if one is set, otherwise uses the Content Group flow. Returns 422 if the project has no evaluation configuration. Job parts must belong to the same project and workflow step and be in a ready state. Returns an async action descriptor; poll its status with tms_get_async_request. (POST /api2/v1/projects/{projectUid}/jobs/evaluateQuality)

Set Phrase TMS job status (POST /api2/v1/projects/{projectUid}/jobs/{jobUid}/setStatus). This operation mutates data.

Search for segments in a Phrase TMS translation memory. (POST /api2/v1/transMemories/{tmUid}/search)

List termbases in Phrase TMS. (GET /api2/v1/termBases)

Update a Phrase TMS job (PUT /api2/v1/projects/{projectUid}/jobs/{jobUid}). This operation mutates data.

Download an analysis file from Phrase TMS in CSV, CSV_EXTENDED, LOG, or JSON format and save it to a local path. (GET /api2/v1/analyses/{analyseUid}/download)

Fetch full details of a single Phrase TMS project, including status, source/target languages, due date, owner, and settings. Use tms_list_projects to find the project UID first if you only know the name. (GET /api2/v1/projects/{projectUid})

List all currently in-progress (RUNNING) async requests across your TMS account. Use for monitoring bulk background operations. To check a specific request by ID, use tms_get_async_request instead. (GET /api2/v1/async)

List all jobs belonging to a specific language part of an analysis in Phrase TMS. Use this when the analysis language part has more than 100 jobs. (GET /api2/v1/analyses/{analyseUid}/analyseLanguageParts/{analyseLanguagePartId}/jobs)

List all available project templates. Use this to discover template UIDs before calling tms_create_project_from_template. For interaction/conversational use, prefer tms_create_project_from_template_shorthand which matches templates by name and skips this lookup. (GET /api2/v1/projectTemplates)

Fetch a specific language part of an analysis in Phrase TMS. Returns word counts, match rates, and up to 100 associated jobs (use tms_list_analysis_language_part_jobs for more). (GET /api2/v1/analyses/{analyseUid}/analyseLanguageParts/{analyseLanguagePartId})

Fetch full details of a single TMS job: status, target language, filename, word count, assigned providers, due date, and workflow step. Note: in workflow projects, each step has a distinct job UID, tms_list_jobs returns one entry per step. (GET /api2/v1/projects/{projectUid}/jobs/{jobUid})

Fetch full details of a project template, including its configured source/target languages, translation memory, machine translation engine, and workflow steps. Use tms_list_project_templates to find the template UID. (GET /api2/v1/projectTemplates/{projectTemplateUid})

Create a Phrase TMS project by applying a template. The template pre-configures language pairs, TM, MT, and workflow. You must know the exact template UID, use tms_list_project_templates to find it, or use tms_create_project_from_template_shorthand to match by name automatically. (POST /api2/v2/projects/applyTemplate/{templateUid})

Create analyses for a set of TMS jobs, grouped by assigned provider. Accepts 1–100 job UIDs. Returns async analysis objects. (POST /api2/v1/analyses/byProviders)

Unlink a TMS project from its Content Group. Idempotent — returns 204 No Content even if no Content Group is currently linked. (DELETE /api2/v1/projects/{projectUid}/contentGroup)

Fetch a single analysis by UID from Phrase TMS. Returns analysis details including word counts, match rates, and associated jobs. (GET /api2/v3/analyses/{analyseUid})

Delete multiple analyses at once from Phrase TMS (1–100 per call). Set purge=true to permanently delete instead of moving to trash. (DELETE /api2/v1/analyses)

Upload a source file to create translation jobs in a Phrase TMS project. One job is created per target language. Common supported formats: XLIFF, PO, DOCX, XLSX, HTML, JSON, SRT, and most standard content formats. Provide either file_path (host filesystem path, for local MCP server use) or file_content + file_name (base64-encoded file bytes, for Claude Desktop uploaded files). (POST /api2/v1/projects/{projectUid}/jobs)

Reopen a job locale in a Phrase Strings project.

Trigger asynchronous generation of the translated (target) file for a TMS job. Returns an asyncRequest object with an id field. The file is NOT immediately available. Next: call tms_get_async_request with the returned id and poll until status = COMPLETED, then call tms_download_target_file_by_async_request to retrieve the file. (PUT /api2/v3/projects/{projectUid}/jobs/{jobUid}/targetFile)

Poll the status of an async operation. Call this after tms_download_target_file_async until the returned status = "COMPLETED". Then proceed to tms_download_target_file_by_async_request. Expected status values: RUNNING, COMPLETED, FAILED. (GET /api2/v1/async/{asyncRequestId})

Search for terms within termbases assigned to a specific Phrase TMS job. (POST /api2/v1/projects/{projectUid}/jobs/{jobUid}/termBases/search)

PREFERRED tool for creating a TMS project from a template in conversational/interactive contexts. Accepts a template name, partial name, UID, or numeric ID, no lookup step needed. Returns an error if the identifier is ambiguous (multiple matches) or not found. (POST /api2/v2/projects/applyTemplate/{templateUid})

Create analyses for a set of TMS jobs, grouped by language pair. Accepts 1–100 job UIDs. Returns async analysis objects. (POST /api2/v1/analyses/byLanguages)

[LEGACY] Trigger an asynchronous quality evaluation against a Quality Profile for the selected TMS job parts. Job parts must be in the same project. Returns an async action descriptor; poll its status with tms_get_async_request. Only available for early-access program users — new users should use tms_evaluate_quality_async which auto-selects the correct flow based on the project's Content Group configuration. (POST /api2/v1/qualityProfiles/evaluate)

Get details for a specific Phrase TMS translation memory. (GET /api2/v1/transMemories/{tmUid})

Search for terms within a Phrase TMS termbase. (POST /api2/v1/termBases/{uid}/search)

Check the async request quota: how many concurrent async operations are allowed and how many are currently in use. Call this before triggering a large number of async exports to avoid hitting rate limits. (GET /api2/v1/async/status)

Export a Phrase TMS translation memory. (GET /api2/v1/transMemories/{tmUid}/export)

Delete a quote from Phrase TMS by UID. This action is irreversible. (DELETE /api2/v1/quotes/{quoteUid})

Email one or more quotes to recipients from Phrase TMS. Returns the list of recipient email addresses the quotes were sent to. (POST /api2/v1/quotes/email)

Retrieve the translated file once async generation is confirmed complete (status = COMPLETED from tms_get_async_request). Returns file content as base64 (bytes_base64) plus content_type and file_name. Optionally saves the decoded file to disk via output_path. (GET /api2/v3/projects/{projectUid}/jobs/{jobUid}/downloadTargetFile/{asyncRequestId})

Import terms into a Phrase TMS translation memory. Provide either file_path (host filesystem path, for local MCP server use) or file_content + file_name (base64-encoded file bytes, for Claude Desktop uploaded files). (POST /api2/v1/transMemories/{tmUid}/import)

Get a single job template in a Phrase Strings project.

Create a new screenshot in a Phrase Strings project. Provide either file_path (host filesystem path, for local MCP server use) or file_content + file_name (base64-encoded image bytes, for Claude Desktop uploaded files). The image file is optional — you can create a screenshot with just a name and description.

Create a new Repo Sync for a Phrase Strings account.

List translations for a locale in a Phrase Strings project.

Upload a new language file in a Phrase Strings project. Provide either file_path (host filesystem path, for local MCP server use) or file_content + file_name (base64-encoded file bytes, for Claude Desktop uploaded files).

Update a term base (previously: glossary) in Phrase Strings.

Update an existing branch in a Phrase Strings project (e.g. rename it).

Create a job in a Phrase Strings project.

List job template locales for a job template in a Phrase Strings project.

Create a comment for a job in a Phrase Strings project.

Get a single term base (previously: glossary) in Phrase Strings.

Show status of an async locale download in a Phrase Strings project.

Update an existing translation key in a Phrase Strings project.

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

Get details on a single translation in a Phrase Strings project.

List all Repo Syncs for a Phrase Strings account.

Merge an existing branch into the main branch of a Phrase Strings project. Note: Merging may take several minutes depending on diff size.

Create a term base (previously: glossary) in Phrase Strings.

Delete an existing project in Phrase Strings.

Create a job template locale for a job template in a Phrase Strings project.

Update an existing translation in a Phrase Strings project.

Remove a target locale from a job in a Phrase Strings project.

Create a locale in a Phrase Strings project.

Create a new branch in a Phrase Strings project. WARNING: Creating a branch copies all keys and translations from the main branch. This operation can take several minutes and consume significant resources on large projects. Only create a branch when explicitly requested by the user.

Get details on a single branch of a Phrase Strings project.

List jobs for a Phrase Strings account.

Initiate async download of a locale in a Phrase Strings project.

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

Delete an existing branch in a Phrase Strings project.

Get a single comment for a job in a Phrase Strings project.

Deactivate an active Repo Sync. Import and export cannot be performed on deactivated syncs and pushes to the repository will not trigger imports to Phrase.

Create a translation for a key and locale in a Phrase Strings project.

Get a single upload in a Phrase Strings project.

List keys in a Phrase Strings project.

Complete a job locale in a Phrase Strings project.

Get a single target locale for a job in a Phrase Strings project.

Create a new translation key in a Phrase Strings project.

Complete a job in a Phrase Strings project.

Remove translation keys from a job in a Phrase Strings project.

Get a single project in a Phrase Strings account.

Import translations from a repository provider to Phrase Strings according to the .phrase.yml file. Import is asynchronous and may take several seconds.

List all branches of a Phrase Strings project.

Get details on a single translation key in a Phrase Strings project.

Create a screenshot marker linking a translation key to a highlighted region on a screenshot in a Phrase Strings project.

Delete an existing locale in a Phrase Strings project.

Get a single Repo Sync setting for a Phrase Strings account.

List uploads for a Phrase Strings project.

Create a job template in a Phrase Strings project.

Fetch the comparison result between a branch and the main branch of a Phrase Strings project. Polls until the comparison is ready (up to 2 minutes). Use after strings_compare_branch.

Activate a deactivated Repo Sync. Active syncs can be used to import and export translations, and imports are automatically triggered by pushes to the repository if configured.

Reopen a completed job in a Phrase Strings project.

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

Export translations from Phrase Strings to a repository provider according to the .phrase.yml file. Export is asynchronous and may take several seconds.

List Phrase Strings projects available for the authenticated account.

Lock a job in a Phrase Strings project.

List comments for a job in a Phrase Strings project.

Update an existing project in Phrase Strings.

Sync an existing branch with the main branch of a Phrase Strings project. Note: Only available for branches created with new branching (currently in private beta).

List terms in a term base (previously: glossary).

List job templates for a Phrase Strings project.

List locales for a Phrase Strings project.

Get details of a single locale in a Phrase Strings project.

List jobs for a Phrase Strings project.

Mark a job locale as reviewed in a Phrase Strings project.

Update an existing term in a Phrase Strings term base (glossary).

List term bases (previously: glossaries) in a Phrase Strings account.

Add translation keys to a job in a Phrase Strings project.

Unlock a job in a Phrase Strings project.

Delete an existing translation key in a Phrase Strings project.

Get a single job in a Phrase Strings project.

Get a single job template locale for a job template in a Phrase Strings project.

List all localization file formats supported in Phrase Strings.

Update a target locale for a job in a Phrase Strings project.

List target locales for a job in a Phrase Strings project.

Create a project in Phrase Strings.

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

Create an async comparison between a branch and the main branch of a Phrase Strings project. Returns a comparison job — use strings_get_branch_comparison to fetch the result.

Update an existing locale in a Phrase Strings project.

Update a job in a Phrase Strings project.

Add a target locale to a job in a Phrase Strings project.

Delete an existing term from a Phrase Strings term base (glossary).