MCP Tools Reference

The Ollang MCP server exposes the following tools, grouped by category. Each tool maps to one or more endpoints in the Ollang Integration API — MCP simply gives your AI assistant a natural-language interface to them.

File Management

uploadFile

Upload files for processing and translation. Supports videos (MP4, AVI, MOV), documents (PDF, DOCX), images in JPEG, JPG, or PNG for Image to Image translation, audio files, subtitles, JSON, and DITA/XML content.Parameters:

Name	Type	Required	Description
`name`	string	Yes	File name (e.g., `video.mp4`, `document.pdf`)
`sourceLanguage`	string	Yes	Source language code (e.g., `en`, `es`, `fr`)
`url`	string	No	URL to download the file from (presigned URLs supported) — fetched server-side, so any file size the API accepts works
`base64Content`	string	No	Base64-encoded binary file content (e.g., a local PDF or DOCX) — best for smaller files
`expectedSize`	number	No	Expected decoded size in bytes of `base64Content`; the upload fails on mismatch
`sha256`	string	No	Expected SHA-256 hex digest of the decoded `base64Content`; the upload fails on mismatch
`content`	string	No	JSON content as a string (not for binary files — use `base64Content`)
`ditaContent`	string	No	DITA/XML content as a string
`notes`	array	No	Array of order notes with `details` and optional `timeStamp`
`folderId`	string	No	Folder ID to place the project in (must belong to the same client)

Provide exactly one of url, base64Content, content, or ditaContent — one source per upload. Base64 payloads travel through the AI assistant’s context, so prefer url for files larger than a few megabytes, and pass expectedSize and/or sha256 with base64Content so uploads fail loudly if the data is corrupted in transit.

uploadVttFile

Upload a VTT subtitle file for a project, from WebVTT content or a URL.Parameters:

Name	Type	Required	Description
`projectId`	string	Yes	The project ID to upload the VTT file for
`name`	string	Yes	Name of the VTT file (e.g., `subtitles.vtt`)
`vttContent`	string	No	WebVTT content as a string (must start with the `WEBVTT` header)
`url`	string	No	URL to download the VTT file from
`sourceLanguage`	string	No	Source language code of the subtitles

Provide exactly one of vttContent or url.

beginChunkedUpload

Start an upload session for binary files too large to send inline in one tool call. Returns an uploadId plus a direct PUT uploadUrl — the preferred path is to PUT the raw file bytes to that URL with any HTTP client, so the file never passes through the AI assistant’s context.Parameters:

Name	Type	Required	Description
`name`	string	Yes	Name of the file (e.g., `document.pdf`)
`sourceLanguage`	string	Yes	Source language code (e.g., `en`)
`expectedSize`	number	Yes	Exact file size in bytes — verified before upload
`sha256`	string	No	SHA-256 hex digest of the file — verified before upload, strongly recommended
`totalChunks`	number	No	Only for the base64-chunk fallback: number of pieces to send via `appendUploadChunk`. Omit when using the PUT `uploadUrl`
`notes`	array	No	Array of order notes
`folderId`	string	No	Folder ID to place the project in

Sessions expire after 60 minutes. As a fallback when no HTTP client is available, send the file’s base64 in pieces with appendUploadChunk, then call finalizeChunkedUpload.

appendUploadChunk

Send one base64 piece of a chunked upload session (fallback path). Chunks are consecutive substrings of the file’s full base64 string.Parameters:

Name	Type	Required	Description
`uploadId`	string	Yes	Session ID from `beginChunkedUpload`
`chunkIndex`	number	Yes	0-based position of this chunk
`base64Chunk`	string	Yes	Consecutive piece of the file’s base64 string, at most 4000 characters
`chunkLength`	number	Yes	Character count of `base64Chunk` — the call fails on mismatch, catching truncation immediately

finalizeChunkedUpload

Assemble all chunks of an upload session, verify integrity (size and optional SHA-256), and upload the file to Ollang. Returns the new projectId.Parameters:

Name	Type	Required	Description
`uploadId`	string	Yes	Session ID from `beginChunkedUpload`

cancelChunkedUpload

Discard a chunked upload session and its stored chunks without uploading.Parameters:

Name	Type	Required	Description
`uploadId`	string	Yes	Session ID from `beginChunkedUpload`

Order Management

createOrder

Create a new translation or transcription order.Parameters:

Name	Type	Required	Description
`projectId`	string	Yes	Project ID from a previous file upload
`orderType`	string	Yes	One of: `cc`, `subtitle`, `document`, `aiDubbing`, `studioDubbing`
`level`	number	Yes	`0` = full AI, `1` = AI + human review
`targetLanguageConfigs`	array	Yes	Array of `{ language: string, isRush?: boolean }` — `language` is an Ollang language code
`orderSubType`	string	No	`cc` orders only: `closedCaption` or `timecodedTranscription`
`dubbingStyle`	string	No	Dubbing orders only: `overdub`, `lipsync`, or `audioDescription`
`selectedMemories`	array	No	Up to 20 translation memory IDs to apply (from `getMemories`)
`autoQc`	boolean	No	Run a QC evaluation automatically once the AI order completes
`callbackUrl`	string	No	HTTPS URL POSTed when the order completes
`aiResultsReadyCallbackUrl`	string	No	HTTPS URL POSTed when AI results are ready, before human review
`humanReviewProgressCallbackUrl`	string	No	HTTPS URL POSTed with human-review progress updates
`metadata`	object	No	Integration-specific metadata persisted on the order

language should be a code from the supported-languages catalogue — pass the exact code returned by getSupportedLanguages or validateLanguageTag rather than guessing a region subtag (Brazilian Portuguese is pt, not pt-BR; pt-PT is Portugal). Ollang’s API itself accepts any well-formed BCP-47 tag beyond the catalogue and falls back to the closest supported match (typically the primary language subtag) when a regional variant isn’t directly recognized — catalogue codes are the ones with verified full provider coverage.

proofreading, revision and other are legacy or system-generated order types. They may appear on existing orders and are accepted by the getOllangOrders type filter, but they cannot be created through this tool.

getOllangOrders

Fetch orders with pagination, search, sorting, and filters. Each order includes its overallQualityScore when a QC evaluation has completed.Parameters:

Name	Type	Required	Description
`page`	number	No	Page number (default: 1)
`take`	number	No	Items per page (1–50, default: 10)
`search`	string	No	Search query
`orderBy`	string	No	Sort field (default: `id`)
`orderDirection`	string	No	`asc` or `desc` (default: `desc`)
`type`	string	No	Only return orders of this order type
`name`	string	No	Filter by order name
`createdFrom`	string	No	Only orders created on or after this ISO-8601 date/time
`createdTo`	string	No	Only orders created on or before this ISO-8601 date/time

getOrderById

Get detailed information about a specific order including QC results.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID

cancelOrder

Cancel an existing order.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to cancel

rerunOrder

Re-run an order to regenerate the translation with current AI models.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to rerun

requestSubtitleEmbedding

Request subtitle embedding for an order to burn (hardcode) the translated subtitles directly into the video file.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to request subtitle embedding for

exportOrderXlsx

Export video timestamps, transcriptions, and translations for an order as an XLSX spreadsheet. Returns a short-lived download URL (expires after 60 minutes) — the file bytes never pass through the AI assistant’s context.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to export

Quality Control

runQcEvaluation

Run an AI-powered quality control evaluation on an order.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to evaluate
`accuracy`	boolean	No	Evaluate translation accuracy (default: true)
`fluency`	boolean	No	Evaluate fluency in target language (default: true)
`tone`	boolean	No	Evaluate tone and style (default: true)
`culturalFit`	boolean	No	Evaluate cultural appropriateness (default: true)
`customPrompt`	string	No	Custom evaluation instructions
`callbackUrl`	string	No	HTTPS URL POSTed when the evaluation completes, with `orderId`, `evalId`, `status`, `textSummary`, `scores` and `segmentEvals`

getOrderReviewInfo

Check whether an order is paused at a review gate, and if so which team tag owns it, the review type (comment or assignment), when it entered review, and who can review it. Use this when an order sits in the review status to find out who is blocking it.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to inspect

requestHumanReview

Escalate an order for manual review by a human translator.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID

cancelHumanReview

Cancel an active human review request. Reverts a Level 1 (Human Review) order back to Level 0 (AI-only), refunds the human review credits, and disconnects the assigned translator. Only Level 1 orders with status ongoing can be cancelled.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID to cancel human review for

Revisions

createRevision

Report issues or request changes to delivered content.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID
`type`	string	Yes	Issue type: `missingSubtitle`, `wrongSubtitle`, `syncError`, `formatError`, `other`
`time`	string	Yes	Timestamp where the issue occurs (format: `HH:MM:SS`)
`description`	string	No	Detailed description of what needs correction

getOrderRevisions

Retrieve all revision requests for an order.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID

deleteRevision

Delete a specific revision request.Parameters:

Name	Type	Required	Description
`orderId`	string	Yes	The order ID
`revisionId`	string	Yes	The revision ID to delete

Projects

getAllProjects

Retrieve all projects with pagination, search, and sorting.Parameters:

Name	Type	Required	Description
`page`	number	No	Page number (default: 1)
`take`	number	No	Items per page (1–50, default: 10)
`search`	string	No	Search query
`orderBy`	string	No	Sort field (default: `id`)
`orderDirection`	string	No	`asc` or `desc` (default: `desc`)

getProjectById

Get detailed information about a specific project.Parameters:

Name	Type	Required	Description
`projectId`	string	Yes	The project ID

Custom Instructions

getAllCustomInstructions

Retrieve all custom translation instructions for your account.Parameters: None

createCustomInstruction

Create a new reusable translation guideline.Parameters:

Name	Type	Required	Description
`title`	string	Yes	Title of the instruction
`content`	string	Yes	The guideline content

updateCustomInstruction

Update an existing custom instruction.Parameters:

Name	Type	Required	Description
`instructionId`	string	Yes	The instruction ID
`title`	string	No	New title
`content`	string	No	New content

deleteCustomInstruction

Delete a custom instruction permanently.Parameters:

Name	Type	Required	Description
`instructionId`	string	Yes	The instruction ID

getCustomInstructionSuggestions

Retrieve suggested preset custom instructions (templates) to adopt or adapt as starting points for your own.Parameters: None

Folders

getAllFolders

Retrieve all folders with pagination, search, and sorting. Folders organize projects — use a folder’s ID as the folderId parameter of uploadFile or beginChunkedUpload to place new projects in it.Parameters:

Name	Type	Required	Description
`page`	number	No	Page number (default: 1)
`take`	number	No	Items per page (1–50, default: 10)
`search`	string	No	Search query
`orderBy`	string	No	Sort field (default: `id`)
`orderDirection`	string	No	`asc` or `desc` (default: `desc`)

getFolderOrderLanguagePairs

Get the distinct source/target language pairs from eligible orders in a folder. Use status=unassigned (default) for pairs available to assign to a translator, or status=assigned for pairs available to unassign.Parameters:

Name	Type	Required	Description
`folderId`	string	Yes	The folder ID to inspect
`status`	string	No	`unassigned` (default) or `assigned`

assignTranslatorToFolderOrders

Batch assign a translator to all eligible (unassigned, completed) orders in a folder, optionally filtered by language pair. Returns the number of orders assigned.Parameters:

Name	Type	Required	Description
`folderId`	string	Yes	The folder ID whose orders to assign
`translatorId`	string	Yes	The translator ID to assign
`deadline`	string	No	Deadline in ISO 8601 format
`sourceLanguage`	string	No	Only assign orders with this source language
`targetLanguage`	string	No	Only assign orders with this target language

unassignTranslatorFromFolderOrders

Batch unassign the translator from all eligible (assigned, ongoing) orders in a folder, optionally filtered by language pair. Returns the number of orders unassigned.Parameters:

Name	Type	Required	Description
`folderId`	string	Yes	The folder ID whose orders to unassign
`sourceLanguage`	string	No	Only unassign orders with this source language
`targetLanguage`	string	No	Only unassign orders with this target language

bulkExportFoldersXlsx

Bulk export orders in folders as a single XLSX file with one sheet per order/language combination. Returns a short-lived download URL (expires after 60 minutes) — the file bytes never pass through the AI assistant’s context.Parameters:

Name	Type	Required	Description
`folderIds`	array	Yes	Folder IDs containing the orders to export
`targetLanguages`	array	Yes	Target language codes to include (e.g., `["tr", "en"]`)

Content Management

exportContent

Export content translations as JSON, filtered by target language(s), tag(s), and order ID(s). Single-language exports return a flat key-value map; multi-language exports return a map grouped by language code.Parameters:

Name	Type	Required	Description
`targetLanguage`	string	No	Filter by a single target language code (e.g., `tr`)
`targetLanguages`	array	No	Filter by multiple target language codes
`tag`	string	No	Filter by a single tag
`tags`	array	No	Filter by multiple tags
`orderIds`	array	No	Filter by one or more order IDs

importContent

Import translation units (source + target text pairs) into your content database. Useful for bulk-loading translations from external systems or TMS exports.Parameters:

Name	Type	Required	Description
`targetLanguage`	string	Yes	Target language code (e.g., `tr`, `en`, `de`)
`translations`	array	Yes	Array of `{ sourceText, targetText, elementId?, type? }`

Translation Memory

A translation memory stores previously approved source/target pairs and reuses them on new orders. Create one, fill it with importMemoryItems, then pass its ID as selectedMemories on createOrder. Only document, subtitle/cc and Adobe AE orders consume them.

getMemories

List all translation memories on the account, each with its stored translation-unit count.Parameters: none.

createMemory

Create an empty translation memory.Parameters:

Name	Type	Required	Description
`title`	string	Yes	Human-readable name (e.g. `Product documentation EN-FR`)

getMemoryById

Retrieve a single translation memory, including how many translation units it stores.Parameters:

Name	Type	Required	Description
`memoryId`	string	Yes	The translation memory ID

updateMemory

Rename a translation memory. Stored translation units are untouched.Parameters:

Name	Type	Required	Description
`memoryId`	string	Yes	The translation memory ID
`title`	string	Yes	New name for the memory

deleteMemory

Permanently delete a translation memory and every translation unit in it.Parameters:

Name	Type	Required	Description
`memoryId`	string	Yes	The translation memory ID to delete

This cannot be undone.

importMemoryItems

Queue translation units for import into a memory. The import runs asynchronously through the same pipeline as dashboard uploads, including the vectorization that makes units available to semantic matching.Parameters:

Name	Type	Required	Description
`memoryId`	string	Yes	The memory to import into
`items`	array	Yes	Array of `{ sourceLanguage, targetLanguage, sourceText, targetText }`

The API accepts up to 1000 units per request, but MCP transports also cap a single tool call’s input — send a few hundred units per call and repeat for larger corpora. Poll getMemoryImportJob with the returned jobId for progress.

getMemoryImportJob

Check the progress of an import job. Reports both the import status and the separate vectorization step.Parameters:

Name	Type	Required	Description
`jobId`	string	Yes	The job ID returned by `importMemoryItems`

Imported units are only available to semantic matching once vectorizationStatus is completed.

Billing and Credits

Both tools require the signed-in Ollang account to have the owner or billing-manager role (client_owner / client_accessBillings); other accounts receive a 403. Ollang MCP authenticates through OAuth, so this is a property of the account you signed in with — there is no API key to configure.

getCreditWallet

Get the account’s AI credit wallet: total, remaining, and used credits with their USD equivalents. Use this to check the balance before starting expensive work, or to explain an out-of-credits error.Parameters: none.

getConsumption

List AI credit consumption line items (one row per provider run) — the same data as the dashboard Consumption Breakdown export. Each line includes creditsUsed, usdEquivalent, provider, service, the requestor and program tags.Parameters:

Name	Type	Required	Description
`page`	number	No	Page number (default: 1)
`take`	number	No	Items per page (1–50, default: 10)
`orderBy`	string	No	Sort field (default: `id`)
`orderDirection`	string	No	`asc` or `desc` (default: `desc`)
`search`	string	No	Search by order name
`from`	string	No	Include consumption from this date onward, inclusive (ISO-8601)
`to`	string	No	Include consumption up to this date, inclusive (ISO-8601)
`provider`	string	No	Filter by provider key (e.g. `openai`, `gemini`, `elevenlabs`)
`orderType`	string	No	Filter by order type
`createdBy`	string	No	Filter by requestor — a user ID or an email address
`orderId`	string	No	Filter by a single order ID
`tag`	string	No	Filter by a single program tag value

Languages

getSupportedLanguages

List the languages Ollang supports, each with its regional variants. Use this to resolve a customer’s wording (“Brazilian Portuguese”) into the exact code createOrder expects — which is pt, since pt-PT is Portugal.Parameters:

Name	Type	Required	Description
`search`	string	No	Search by name, native name, or code (minimum 2 characters, e.g. `portu`). Omit to list all primary languages

validateLanguageTag

Check a language code against the platform catalogue. Returns whether it is accepted, its parsed language and region, and the reasons it failed.Parameters:

Name	Type	Required	Description
`tag`	string	Yes	Language code to check (e.g. `pt`, `pt-PT`, `es-MX`, `zh-Hant`)

createOrder, uploadFile, and project creation expect a code from the supported-languages catalogue for guaranteed full coverage — check here whenever a code is uncertain, especially before assuming a region subtag such as pt-BR exists. Ollang’s API also accepts any well-formed BCP-47 tag beyond the catalogue, falling back to the closest supported match (typically the primary language subtag) when a regional variant isn’t directly recognized.

Utilities

healthCheck

Check the health status of the Ollang API.Parameters: None

downloadAndReadSubtitle

Download and parse subtitle files from URLs. Supports SRT, VTT, ASS, and SSA formats.Parameters:

Name	Type	Required	Description
`url`	string	Yes	URL of the subtitle file
`format`	string	No	Format hint: `auto`, `srt`, `vtt`, `ass`, `ssa` (default: `auto`)

downloadAndReadJSON

Download and parse JSON files from URLs.Parameters:

Name	Type	Required	Description
`url`	string	Yes	URL of the JSON file

downloadAndReadDITA

Download and parse DITA/XML documentation files from URLs.Parameters:

Name	Type	Required	Description
`url`	string	Yes	URL of the DITA file (.dita, .ditamap, or .ditaval)

Ollang MCP

Integrations

Use Cases

Available Tools

MCP Tools Reference

File Management

Order Management

Quality Control

Revisions

Projects

Custom Instructions

Folders

Content Management

Translation Memory

Billing and Credits

Languages

Utilities

​MCP Tools Reference

​File Management

​Order Management

​Quality Control

​Revisions

​Projects

​Custom Instructions

​Folders

​Content Management

​Translation Memory

​Billing and Credits

​Languages

​Utilities

MCP Tools Reference

File Management

Order Management

Quality Control

Revisions

Projects

Custom Instructions

Folders

Content Management

Translation Memory

Billing and Credits

Languages

Utilities