General Translation

List accessible GT projects with Google Drive integrations and their locale options. Optionally provide both fileId and hostApp for linked-file and translated-copy context. Users can use their linked Google account or an organization integration; API keys require an organization integration.

get_google_drive_context

Poll translation and layout progress for a Google Docs, Slides or Sheets file and get translated-copy URLs when available. A GT-managed translated copy resolves to its source and its target locale. Users can use their linked Google account or an organization integration; API keys require an organization integration.

get_google_drive_translation_status

Gets a context group's ID and name. Requires `org:context:read`.

get_context_group

Download one source file, or its translation when locale is given, as base64. A file too large to return inline has null data and a downloadUrl to fetch it from; media files always carry a downloadUrl. Reads the default branch unless branchId is given, and the branch head unless versionId is given. Without versionId, a translation is the newest completed version on the branch, and pending only while none is completed; to wait for a specific version, pass its versionId. Returns a query_files_content result: status ready with the content, or status pending with fileId, branchId, versionId, locale and null data when the translation is stored but not completed yet, for example during a layout pass. A missing file is an error, as is a translation while its translation job has not stored the translation yet, so wait for the job with get_job or query_jobs before reading it.

get_file_content

Get source and translated file metadata, including approval, completion, and publication dates, for up to 100 selectors. Each selector reads the default branch unless branchId is given, the branch head unless versionId is given, and the source file unless locale is given; a selector repeated field for field is rejected. Returns one result per selector, in selector order: status found with the metadata (completed translations only), status pending when the translation is stored but not completed yet, for example during a layout pass, or status not_found, including while its translation job has not stored the translation yet, so wait for the job with get_job or query_jobs before reading it.

query_files

Return a source file's metadata and the translation state of each locale. Reads the default branch unless branchId is given, and the branch head unless versionId is given.

get_file_status

Gets a glossary term by ID: its keyword and definition. Translations are listed separately. Requires `org:context:read`.

get_context_glossary_entry

Return the status of a file translation or context generation job started by translate_files or generate_project_context. Poll until the status is completed or failed; a failed job reports its error.

get_job

Return the statuses of up to 100 file translation or context generation jobs by ID, such as the jobs returned by translate_files, one result per job in request order; a job not in the project is not_found and a repeated ID is rejected. Poll until every status is completed or failed; failed jobs report their error.

query_jobs

Return locale, approval and CDN delivery settings for a project. Use list_projects to find project IDs.

get_project

Gets one assignment of a context group to a project: the group's ID, name and priority. Requires `org:context:read`.

get_project_context_group

Download up to 100 source and translated files as base64. A file too large to return inline has null data and a downloadUrl to fetch it from; media files always carry a downloadUrl. Each selector reads the default branch unless branchId is given, the branch head unless versionId is given, and the source file unless locale is given; a selector repeated field for field is rejected. Returns one result per selector, in selector order: status ready with the content, status pending when the translation is stored but not completed yet, for example during a layout pass (request it again later), or status not_found, including while its translation job has not stored the translation yet, so wait for the job with get_job or query_jobs before reading it. Without versionId, a translation is the newest completed version on the branch, and pending only while none is completed; to wait for a specific version, pass its versionId.

query_files_content

Merges one JSON or CSV transfer document of glossary terms and custom prompts (up to 1 MiB as a JSON string, so escaped quotes and line breaks count) into a context group as one atomic batch. The whole document is validated before anything is written. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. In CSV, a blank prompt locale means every locale, and the term, prompt name and prompt text can't be blank. For larger imports, send several documents; each commits on its own. Requires `org:context:write`.

import_context_content

Lists the files on a branch with their head version, in the order they were added to the branch. To find files removed locally, compare the listed file IDs with your own. Requires `project:files:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_branch_files

List the project's branches ordered by ID, each marked with whether it is the default branch. Pass name to find branches by exact name, and isDefault to find the default branch. Use the returned branch IDs in file operations. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_branches

Lists the org's context groups, ordered by ID. Requires `org:context:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_context_groups

Lists a context group's custom prompts by ID. A null locale means the prompt applies to every locale. Requires `org:context:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_context_custom_prompts

Lists a context group's glossary terms by ID, without translations. keyword is optional and matches the stored keyword exactly (case-sensitive), so it returns at most one term. Requires `org:context:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_context_glossary

List organizations you belong to. Use the returned IDs as orgId in organization tools. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_orgs

Lists the context groups assigned to a project, in priority order. Requires `org:context:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_project_context_groups

List projects you are a member of. Use the returned IDs as projectId in project tools. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_projects

Lists a glossary term's translations by ID. Requires `org:context:read`. Omit `cursor` for the first page. When the response's `nextCursor` is a string, pass it as `cursor` to fetch the next page; when it is `null`, there are no more results.

list_context_glossary_translations

Move or rename 1–25 files by cloning each latest source file and its translations under a new file ID, and return one result per move. Each old and new file ID may appear once, and no file ID may be both an old and a new file ID: a batch that swaps, cycles or chains file IDs is rejected without changing anything.

move_files

Replace 1–100 existing translations with full translated file content and return one result per translation. Each branch, file, version and locale may appear once; retrying failed translations with the same content is safe, but it re-saves them, which can repeat completed webhooks and revisions.

overwrite_translations

Publish or unpublish the translations of 1–100 file versions on the CDN and return one result per version, with a result for each translation. Each branch, file and version may appear once.

publish_files

Moves a context group assigned to a project to a new zero-based position; lower positions win for duplicate terms. Requires `org:context:write`.

reorder_context_group

Create a tag pointing to source file versions, or replace an existing tag whole: its files become exactly files and its message becomes message, cleared when omitted. created reports which. Every file reference must resolve in the project, otherwise nothing is written.

set_tag

Creates or replaces one locale's translation of a glossary term (outcome reports which). Keeps the term and its other translations. Requires `org:context:write`.

set_context_glossary_translation

Report friction with the General Translation MCP tools to the General Translation team. Use it when no tool could do what the user asked, a tool failed or returned something wrong, a tool or its docs were unclear, or you have a suggestion. Call at most once per task, after you finish or give up, then tell the user what you reported. Feedback goes to the General Translation team, not to the user's organization, and does not perform the requested fix.

submit_feedback

Sync a Google Docs, Slides or Sheets file, enqueue translations, and apply them to Drive copies on completion. Imports edits from existing translated copies. May incur translation charges and update existing copies. Inspect enqueued, failed, and errors for partial success, then poll get_google_drive_translation_status. A GT-managed translated copy resolves to its source and only its target locale. Users can use their linked Google account or an organization integration; API keys require an organization integration.

translate_google_drive_file

Translate strings, structured entries, or markdown documents using project context and caching, and return the translations directly. The content is not saved to the platform as a file or translation job. To translate a file, use upload_source_files and translate_files instead. This may incur translation charges. Each key in translations holds its own result; inspect every result for success: false.

translate_content

Queue up to 100 uploaded source files for background translation into the target locales (the project's current locales when omitted). Returns one job per file and locale that needs translating; files already translated into a locale get no job unless force is set, so jobs may be empty. Each file must be listed once and exist on its branch, or nothing is queued. Adds the target locales to the project's current locales; the project default locale is unchanged. This may incur translation charges. publish controls CDN publication. Poll the returned jobs with get_job or query_jobs.

translate_files

Removes a context group's assignment to a project and keeps the group and its content. Does nothing if the group isn't assigned. Requires `org:context:write`.

unassign_context_group

Rename a branch or make it the default branch, and return it. Omitted fields are unchanged. Making a branch the default unsets the previous default. A name another branch uses is rejected. Use list_branches to find branch IDs.

update_branch

Renames a context group or turns its automatic updates on or off. With automatic updates off, translation runs never add terms or context to the group. Requires `org:context:write`.

update_context_group

Updates a custom prompt by ID. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. Fails if another prompt already has the resulting name and locale. Requires `org:context:write`.

update_context_custom_prompt

Update 1–100 existing source files or translations, such as their preview URL, and return each after the update. A file without a locale is the source version; with one, its translation. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. Each file version and locale may appear once. Writes nothing when a source file version or translation does not exist, or when a source file version belongs to an integration; repeating a request is safe.

update_files

Updates a glossary term's keyword or definition. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. The term ID and translations are kept when the keyword is renamed. Fails if another term already has the keyword. Requires `org:context:write`.

update_context_glossary_entry

Update the project default source locale or CDN publishing setting, and return the updated project. This tool does not publish or unpublish existing files. Omitted settings remain unchanged.

update_project

Upload 1–100 source files with base64-encoded content and return one result per file. Uploaded files are saved to the platform. They can then be translated with translate_files, or existing translations can be added with upload_translations. Rejects the whole request without saving anything when any file's content is not valid base64 or does not parse in its format. Existing source versions are saved again; retrying failed files with the same content and identifiers is safe. Does not change the project default locale. LOTTIE content must be a base64-encoded .lottie ZIP archive, and PNG, JPEG, and MP4 content must be the base64-encoded file.

upload_source_files