io.github.transloaditPublished by GitHub account transloaditv0.8.6Updated Nov 6, 2026
Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.
Transloadit media processing: lets an assistant encode video, edit images, convert documents, transcribe audio and capture webpages through Transloadit Robots.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.transloadit%2Fmcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"transloadit-media-processing": {
"type": "http",
"url": "https://api2.transloadit.com/mcp"
}
}
}Transloadit MCP Server (Streamable HTTP + stdio), built on top of @transloadit/node.
The hosted server lives at:
Add it to your MCP client by URL. The client discovers API2 as the OAuth authorization server, opens a browser consent page in the Transloadit Console, and keeps a short-lived token plus refresh token for you. No API keys leave your Workspace.
The hosted endpoint asks you to sign in before any tool runs, Robot docs and linting included, because MCP clients only start OAuth when the endpoint challenges them. Robot docs and linting ask for no scopes. To use them without an account, run the server yourself (see Self-hosted).
For non-interactive runs (for example claude -p), explicitly allow MCP tools:
Settings → Connectors → Add custom connector → enter https://api2.transloadit.com/mcp. Claude
registers itself with API2 and opens the consent page.
Settings → Apps & Connectors → Advanced → Developer mode → Create, then enter the URL above with
authentication set to OAuth. Files you attach in the chat are handed to
transloadit_create_assembly as attachments; results render in the Assembly result widget.
The plugin manifest for the ChatGPT and Codex catalog (plugin.json, mcp.json and the
.codex-plugin/plugin.json fallback) lives in this package directory. It points at the hosted
server and at the Agent Skills catalog at https://transloadit.com/.well-known/skills/index.json
instead of bundling skill files.
Codex opens the consent page right away. To sign in again later, run
codex mcp login transloadit.
Or in ~/.codex/config.toml:
~/.cursor/mcp.json:
Where no browser is available, mint a bearer token from an Auth Key and pass it as
Authorization: Bearer <token>:
Generate this token in a trusted environment (backend, CI, or local shell), then hand it to the agent runtime. You can mint it via:
npx -y @transloadit/node auth token --aud mcpPOST https://api2.transloadit.com/token (HTTP Basic Auth with key/secret)Transloadit with authKey + authSecret, then call
client.mintBearerToken({ aud: 'mcp' })Interactive CLI sessions can also run npx -y @transloadit/node auth login (device flow) and reuse
the stored credentials.
Bearer tokens satisfy signature auth on API2 requests; signature checks apply to key/secret requests.
Run the server where your agent runs, set TRANSLOADIT_KEY and TRANSLOADIT_SECRET, and the server
handles API auth automatically.
Auth Keys sign with one HMAC algorithm. Keys created in the Console with "Allow signing Smart CDN
URLs" (the default) require sha256, so add TRANSLOADIT_SIGNATURE_ALGORITHM=sha256, as the
Console's snippet for the key shows. Other keys use the default sha384. A mismatch fails with
mcp_invalid_signature, and its hint names the algorithm the key requires.
When binding HTTP mode to non-localhost hosts, TRANSLOADIT_MCP_TOKEN (or the hosted-mode
TRANSLOADIT_MCP_RESOURCE_METADATA_URL) is required.
For HTTP mode via Docker, override the stdio entrypoint, expose the port, and set a transport
token, which binding to 0.0.0.0 requires:
TRANSLOADIT_MCP_TOKEN explainedTRANSLOADIT_MCP_TOKEN is a self-hosted MCP transport token. It protects your own HTTP MCP endpoint
(npx -y @transloadit/mcp-server http), not API2.
Authorization: Bearer <TRANSLOADIT_MCP_TOKEN>./token.https://api2.transloadit.com/mcp.Generate one, then start HTTP mode:
Most self-hosted users add the server to their MCP client and let the client start it via stdio.
Allowlist tools in ~/.codex/config.toml:
Allowlist tools in ~/.gemini/settings.json:
~/.cursor/mcp.json:
~/.config/opencode/opencode.json:
https://api2.transloadit.com/mcp)401 with
WWW-Authenticate: Bearer resource_metadata="https://api2.transloadit.com/.well-known/oauth-protected-resource/mcp".
MCP clients follow that document to API2's authorization server (authorization code + PKCE,
Dynamic Client Registration or Client ID Metadata Documents).GET /mcp, because some clients (Codex) discover the authorization server
from that probe. Directory health checks therefore see 401 instead of 200; the JSON body
still carries name, status and docs. Self-hosted and unauthenticated deployments keep
answering the bare GET with 200.--aud mcp) are forwarded to API2, which verifies them on
every call. A rejected or expired token yields a tool result with isError and
_meta["mcp/www_authenticate"], so ChatGPT and Claude prompt you to reconnect.securitySchemes (top level and in _meta). Because the hosted endpoint
challenges every unauthenticated request, all tools declare oauth2 there; the Robot docs and
linting tools ask for no scopes.mcp_credentials_rejected without an OAuth challenge, since only an operator can fix it.Origin header (CLIs, servers) are not restricted. Set allowedOrigins to change the list.TRANSLOADIT_MCP_UPSTREAM_SECRET is set by Transloadit's own deployment so API2 can tell that a
relayed aud=mcp token arrives from the hosted service; it is not needed for self-hosting.
Hosted mode refuses to start without it, because every authenticated call would fail.TRANSLOADIT_MCP_TOKEN (a static secret you define).TRANSLOADIT_KEY + TRANSLOADIT_SECRET.TRANSLOADIT_KEYTRANSLOADIT_SECRETTRANSLOADIT_SIGNATURE_ALGORITHM (optional, sha1, sha256 or sha384, default sha384;
must match the Auth Key)TRANSLOADIT_MCP_TOKENTRANSLOADIT_MCP_RESOURCE_METADATA_URL (hosted mode: protected-resource metadata URL to
advertise in 401 challenges)TRANSLOADIT_MCP_UPSTREAM_SECRET (hosted mode only, set by Transloadit's deployment; sent to
API2 as Transloadit-Mcp-Upstream next to forwarded bearer tokens)TRANSLOADIT_MCP_RESULT_DOMAINS (optional, comma-separated origins the result widget may load
previews from and link to, either exact such as https://tmp-us-east-1.transloadit.net or with a
wildcard host; default https://*.transloadit.com,https://*.transloadit.net,https://*.r2.dev)TRANSLOADIT_MCP_WIDGET_DOMAIN (optional, default https://transloadit.com; the origin ChatGPT
serves the result widget from, sent as _meta["openai/widgetDomain"])TRANSLOADIT_MCP_CONSOLE_URL (optional, default https://transloadit.com; Console origin for
widget deep links)TRANSLOADIT_ENDPOINT (optional, default https://api2.transloadit.com)TRANSLOADIT_MCP_METRICS_PATH (optional, default /metrics)TRANSLOADIT_MCP_METRICS_USER (optional)TRANSLOADIT_MCP_METRICS_PASSWORD (optional)npx -y @transloadit/mcp-server http --host 127.0.0.1 --port 5723npx -y @transloadit/mcp-server http --endpoint https://api2.transloadit.comnpx -y @transloadit/mcp-server http --config path/to/config.jsonThe JSON config accepts the same keys as createTransloaditMcpHttpHandler(), including
allowedOrigins, resourceMetadataUrl, signatureAlgorithm, resultDomains, widgetDomain and
consoleUrl.
Every tool carries title, readOnlyHint, destructiveHint, idempotentHint and
openWorldHint annotations. transloadit_create_assembly is the only destructive one: export
Robots such as /s3/store can overwrite files at their destination, so hosts should confirm it.
transloadit_lint_assembly_instructions validates complete, merged instructions locally. It does
not fetch the Template named by template_id: resolve the Template and merge any Assembly or
replay overrides before linting. For example, an OCR Step that inherits ocr_provider must
include that provider in the instructions passed to this tool.
securitySchemes depend on how the server runs: hosted (TRANSLOADIT_MCP_RESOURCE_METADATA_URL)
declares oauth2 with the scopes above for every tool; a server holding TRANSLOADIT_KEY and
TRANSLOADIT_SECRET declares noauth everywhere; otherwise the account tools declare oauth2 and
the others noauth. TRANSLOADIT_MCP_TOKEN and TRANSLOADIT_MCP_RESOURCE_METADATA_URL cannot be
combined.
Authenticated tools/list is the reference for outcome shortcuts, descriptions and field schemas.
The synced alphalib Builtin manifest supplies
reviewed version pins and temporary field exclusions. The MCP adapter derives tool names and
titles from those IDs and consumes the catalog schema through @transloadit/zod/v4/builtinTemplates.
An alphalib sync carries approved additions, renames, removals and gate changes without another
MCP registry.
Each shortcut’s description starts with the tool-ready summary API2 authors beside the Builtin
definition: the credential’s catalog summary once read, and otherwise the synced
mcpBuiltinTemplateSummaries, which the server card and pre-catalog tools/list use. The long
catalog description is not tool text. Standalone draft-07 fields_schema and content.fields
defaults come from API2’s Template catalog. Defaults merge before validation, preserving JSON types; conservative schema
annotations leave runtime cross-field validation authoritative. A null or absent contract makes
that shortcut unavailable. Generic tools keep their existing behavior.
The manifest’s temporary legacy VP8 webm gate remains until
api2#9960 is deployed and verified.
Social captions are deferred. Transcription language hints do not translate speech.
Catalog reads have a three-second overall deadline without retries. During an authenticated
catalog outage the reviewed names remain discoverable with permissive fields; each call still
fetches and validates the current contract. Malformed or default-sensitive composed schemas also
use permissive discovery, followed by full validation after merging defaults at execution.
Supply fields and the same files/attachments/upload/wait options as transloadit_create_assembly.
For a sandbox file, set expected_uploads, run the returned upload command, then call
transloadit_wait_for_assembly. The SDK already includes the
document extraction registry fix.
transloadit_list_templates supports:
include_builtin: all, latest, exclusively-all, exclusively-latestinclude_content: include parsed steps in each template itemBuiltin items also carry fields_schema unchanged, including conservative-fidelity metadata
and null for older Builtins without a declared schema. Workspace Templates omit that property.
transloadit_get_profile returns { id, name?, nickname? } for the Workspace behind the current
credentials, derived from the Workspace's own Assemblies or Templates.
transloadit_create_assembly and transloadit_wait_for_assembly link the MCP Apps resource
ui://transloadit/assembly-result (_meta.ui.resourceUri, also _meta["openai/outputTemplate"]).
Hosts that support MCP Apps render each Step's results with image, video and audio previews,
download links, an "Open in Console" link and a "Save as Template" shortcut. It speaks the MCP Apps
2026-01-26 protocol (ui/initialize with appInfo) and also reads ChatGPT's window.openai.
Its CSP allows https://*.transloadit.com, https://*.transloadit.net and https://*.r2.dev
(result buckets); override the list with TRANSLOADIT_MCP_RESULT_DOMAINS or resultDomains.
ChatGPT asks for the exact hosts a widget uses, so a deployment that knows its result buckets
should list them as origins instead of wildcards. ChatGPT also needs redirect_domains to open
links from the widget: the server sends the result origins plus the Console origin there. ChatGPT
serves the widget from the origin in _meta["openai/widgetDomain"]
(TRANSLOADIT_MCP_WIDGET_DOMAIN). ui.domain stays unset, because Claude derives that value from
the server URL and rejects any other.
Hosts that attach chat files (ChatGPT) pass them under attachments instead, as declared by
_meta["openai/fileParams"]:
Each attachment becomes a URL input (attachment_1, attachment_2, …) and follows the URL rules
below.
If the file exists only locally or in your sandbox, call transloadit_create_assembly with
expected_uploads and run the returned upload_instructions; this needs outbound HTTPS from the
sandbox to Transloadit (Claude.ai: Settings → code execution network access must allow it). Hosts
such as Claude.ai do not hand chat attachments to connector tools, and base64 in tool arguments is
impractical for anything but tiny files, so the agent uploads the file itself:
transloadit_create_assembly with your instructions and expected_uploads: 1 (one per
file, at most 100 per call). The call returns right away, even with wait_for_completion: true,
because the Assembly now waits for those uploads.upload_instructions entry has the tus endpoint, the tus metadata (assembly_url,
fieldname) and a ready-to-run curl command. Set FILE to the file's path and run it in a
bash shell; it prints 201 once the file is uploaded (tus creation-with-upload, one request).transloadit_wait_for_assembly with the Assembly URL.Calling transloadit_create_assembly with assembly_url and expected_uploads (all uploads the
Assembly expects, as at creation) hands out upload_instructions for the uploads an existing
Assembly still waits for.
The commands contain no credentials: the Assembly URL is the only capability, and it lets the holder add files to that one Assembly while it waits for uploads.
These limits apply to inline JSON/base64 payloads. For larger files, use a public URL or upload from
your own machine with npx -y @transloadit/node upload.
maxBase64Bytes: 512,000 decoded bytesSet maxRequestBodyBytes (handler option or JSON config key) to change the body limit; larger
requests get HTTP 413 and are not buffered. Express apps that install their own body parser set
its limit there.
URL inputs that the server downloads (for templates that expect uploads) are capped at 1 GiB in
total per call and 10 minutes per download, redirects included; set maxUrlDownloadBytes and
urlDownloadTimeoutMs to change that. On the hosted
endpoint the caller's token is checked with API2 before anything is downloaded. Downloads count
toward the wait budget below: when they do not finish in time, no Assembly is created and the call
returns mcp_preparation_timeout, so a retry is safe. The download is stopped about a second
later and its file removed.
MCP hosts abandon tool calls that run too long (ChatGPT after about a minute) and may retry them,
which would create a second Assembly. transloadit_create_assembly, the Builtin shortcuts and
transloadit_wait_for_assembly therefore wait at most 45 seconds, even with a larger
wait_timeout_ms/timeout_ms. When that budget is spent, the call returns the Assembly with its
current status (a last status read or a slow creation request may take up to 5 seconds more, so
keep the budget that far below the host's limit), running: true and an mcp_assembly_still_running notice; uploads and processing
continue, and transloadit_wait_for_assembly or transloadit_get_assembly_status follow it. Set
maxWaitMs (option or JSON config key) or TRANSLOADIT_MCP_MAX_WAIT_MS to change the budget.
For URL inputs, behavior depends on the template/instructions:
/http/import Step exists, MCP sets/overrides that Step's url.:original or /upload/handle), MCP downloads then uploads via
tus. These downloads require public HTTP(S) URLs; private-network targets are rejected, including
redirects to private addresses.allow_steps_override=false and only /http/import would work, URL inputs are rejected.The Builtin shortcuts for caption-video, convert-to-pdf, encode-video, extract-text,
prepare-image, remove-background, transcribe and video-covers send URLs to API2 as
input_url next to template_id when every file
and attachment of the call is a URL (up to 10, one for caption-video). Transloadit then fetches
the files itself, so the Assembly exists at once and nothing is downloaded by the MCP server or held
up by a large file. API2 names the files after their URLs (or redirects and Content-Disposition),
so inputs given a file name, such as host attachments, keep the download path above, as do calls
that mix URLs with base64 files or sandbox uploads, calls with upload_behavior: 'none', and URLs
that API2 would refuse (whitespace, |, ${…}, over 4096 characters). If API2 refuses
input_url for the request, its error is returned like any other. The eligible Builtins are listed
in the alphalib Builtin manifest.
kind: 'path' must switch to base64, a public URL,
or a local CLI upload. This also applies to stdio and self-hosted servers.url inputs, small base64 payloads, or upload locally with
npx -y @transloadit/node upload.expected_uploads to keep an Assembly open for out-of-band tus uploads.If assembly_url is provided, MCP resumes uploads using Assembly status (tus_uploads +
uploads). This requires stable field names and file metadata (filename + size).
Resubmit the same base64 or public URL input to resume an upload. URL inputs are downloaded and
uploaded even when the original instructions are omitted; resumption does not modify the existing
Assembly's Steps. The file's contents, field name, and filename must remain unchanged.
This resumes tus uploads; URL imports performed by /http/import do not need to be resubmitted.
Assembly IDs must contain 32 hexadecimal characters. Assembly URLs must refer to a Transloadit host
or the explicitly configured API origin, without credentials, query parameters, or fragments.
MCP extracts the ID and resolves the Assembly through its configured API endpoint; it never fetches
the caller-supplied Assembly URL directly. MCP does not follow API response redirects, including an
Assembly's redirect_url. A custom endpoint can use a local origin for development,
but this does not enable private-network URL file downloads.
GET /metrics by default.TRANSLOADIT_MCP_METRICS_PATH or metricsPath.metricsPath: false.TRANSLOADIT_MCP_METRICS_USER +
TRANSLOADIT_MCP_METRICS_PASSWORD or metricsAuth./.well-known/mcp/server-card.json declares tools: ["dynamic"];
authenticated tools/list supplies the complete inventory, schemas, annotations and security
schemes. Hosted cards also publish the OAuth resource metadata URL.These are guidelines, not strict rules. Many teams use both.
Run a local smoke test with published MCP server and installed CLIs (Claude Code, Codex CLI,
Gemini CLI). Requires TRANSLOADIT_KEY + TRANSLOADIT_SECRET and active CLI auth.
Set MCP_VERIFY_TIMEOUT_MS to override command timeout.
From repo root:
test:e2e requires valid Transloadit credentials in your environment.
transloadit/node-sdk.Source: packages/mcp-server/README.md at commit ddfddcb
Lint Assembly Instructions
Lint complete, merged Assembly Instructions without creating an Assembly. Resolve template_id and merge any Template or replay overrides before calling; this tool does not fetch Templates. Returns structured issues.
strictinstructionsrequiredreturn_fixedCreate or resume an Assembly
Create an Assembly from instructions (Steps or a template_id), or resume one by assembly_url, optionally uploading files and waiting for completion. Files attached in the chat arrive under attachments; public URLs and small base64 payloads go under files. If a file exists only locally or in your sandbox, set expected_uploads and run each returned upload_instructions curl command there (it needs outbound HTTPS to Transloadit). Waiting stops after a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing, and next_steps say how to follow it instead of creating it again.
filesfieldsattachmentsassembly_urlinstructionsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionCaption video
Transcribe the speech in videos and burn plain captions into each original video. Returns the captioned video and its SRT captions. Fields set the caption font_size (default 16), position, font_color and border_color. The automatic provider detects the spoken language; target_language (such as french) hints it, and source_language (default en-US) sets it for provider aws or gcp. Captions are never translated. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionCapture webpage
Capture a public HTTP(S) webpage (url) or an uploaded HTML file as a PNG, JPEG or PDF. Returns one image or PDF per captured page. Defaults to a full-page PNG 1024 pixels wide; set fullpage to false for a fixed width × height viewport, and use delay or wait_until for late-loading pages. A url takes precedence over uploaded HTML. No custom headers, credentials or browser actions are sent. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionConvert to pdf
Convert Office documents, HTML, Markdown and plain text files to PDF. Returns one PDF per input. Fields set the paper size (pdf_format, default Letter), pdf_margin, background printing, and the Markdown flavor and theme. Paper and margin fields apply to HTML and Markdown; Office and text files keep the converter’s native layout. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionEncode video
Encode videos for web playback with an MP4 or WebM preset. Returns one encoded video per input. Defaults to the 720p MP4 preset with turbo encoding; width or height override that preset dimension. Output size depends on the source and preset. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionExtract text
Extract text from images, PDFs and Office documents as plain text (default) or JSON. Returns one text result per input by default. Images use OCR; documents try embedded text before OCR, and Office files are converted to PDF first. Fields set text_method, the OCR provider (AWS or GCP), page_range, password and text_granularity, where page returns one result per page; those last three need native extraction. Unsupported formats are skipped. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionPrepare image
Prepare images for a website: auto-orient, fit within 1600×1600 pixels without enlarging, encode as WebP at quality 75, strip metadata and keep transparency. Returns one image per input. Fields set width and height (w, h), format (f), quality (q), resize strategy (r), background color (bg) and metadata stripping (strip). JPEG output needs an opaque background. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionRemove background
Remove the background from photos. Returns the foreground of each image as a transparent PNG. Fields set the provider (automatic by default); only provider transloadit also allows GIF or WebP output, or keeping the background instead of the foreground. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionTranscribe
Transcribe the speech in audio or video files. Returns one transcript per input as timestamped JSON (default), plain text, SRT or WebVTT. The automatic provider detects the spoken language; target_language (such as french) hints it, and source_language (default en-US) sets it for provider aws or gcp. Transcripts are never translated. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionVideo covers
Extract cover images from videos. Returns 8 JPEG frames per video by default, taken at regular intervals, or frames at exact offsets in seconds or percentages. Set smart to true to have AI scoring pick the strongest count frames from up to three candidates per frame, capped by smart_max_candidates but never fewer than count. Fields also set format (JPEG or PNG), width and height, which default to the video’s dimensions. Pass the Builtin’s parameters under fields. Provide inputs as attachments (files shared in the chat), files (public URLs or small base64 payloads) or expected_uploads (files that exist only locally or in a sandbox; the result returns an upload_instructions curl command per file). Set wait_for_completion to wait up to a server budget (45 seconds by default). Returns the Assembly with its result files; running: true means it is still processing.
filesfieldsattachmentsupload_behaviorwait_timeout_msexpected_uploadsupload_chunk_sizeupload_concurrencywait_for_completionGet Assembly status
Fetch the current status and result files of an Assembly by assembly_url or assembly_id, without waiting.
assembly_idassembly_urlWait for Assembly completion
Polls until the Assembly completes, timeout_ms passes or the server budget (45 seconds by default) is spent. A result with running: true is still processing; call this again to keep following it.
timeout_msassembly_idassembly_urlpoll_interval_msList Transloadit Robots
List Transloadit Robots, the processing units used in Assembly Steps, with short summaries. Filter by category or search text; page with cursor.
limitcursorsearchcategoryGet Robot parameter help
Returns the summary, required and optional parameters and examples for one Robot (robot_name) or several (robot_names), for writing Assembly Steps.
robot_namerobot_namesdetail_levelList Templates
List Assembly Templates (owned and/or builtin). Tip: pass include_builtin: "exclusively-latest" to list builtins only.
pagesortorderkeywordspage_sizeinclude_builtininclude_contentGet connected Workspace
Returns a stable identifier and name for the Transloadit Workspace behind the current credentials, so hosts can tell connected accounts apart.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
https://api2.transloadit.com/mcpclaude mcp add --transport http transloadit https://api2.transloadit.com/mcpclaude mcp login transloaditclaude -p "List templates" \ --allowedTools mcp__transloadit__* \ --output-format jsoncodex mcp add transloadit --url https://api2.transloadit.com/mcp[mcp_servers.transloadit]url = "https://api2.transloadit.com/mcp"{ "mcpServers": { "transloadit": { "url": "https://api2.transloadit.com/mcp" } }}npx @modelcontextprotocol/inspector --cli https://api2.transloadit.com/mcpnpx -y @transloadit/node auth token --aud mcpnpm install @transloadit/mcp-serverTRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server stdioTRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY \npx -y @transloadit/mcp-server http --host 127.0.0.1 --port 5723docker run -i --rm \ -e TRANSLOADIT_KEY=MY_AUTH_KEY \ -e TRANSLOADIT_SECRET=MY_SECRET_KEY \ ghcr.io/transloadit/mcp-server:latestexport TRANSLOADIT_MCP_TOKEN="$(openssl rand -hex 32)"docker run --rm \ -e TRANSLOADIT_KEY=MY_AUTH_KEY \ -e TRANSLOADIT_SECRET=MY_SECRET_KEY \ -e TRANSLOADIT_MCP_TOKEN \ -p 5723:5723 \ --entrypoint transloadit-mcp \ ghcr.io/transloadit/mcp-server:latest \ http --host 0.0.0.0 --port 5723export TRANSLOADIT_MCP_TOKEN="$(openssl rand -hex 32)"npx -y @transloadit/mcp-server http --host 0.0.0.0 --port 5723claude mcp add --transport stdio transloadit \ --env TRANSLOADIT_KEY=... \ --env TRANSLOADIT_SECRET=... \ -- npx -y @transloadit/mcp-server stdiocodex mcp add transloadit \ --env TRANSLOADIT_KEY=... \ --env TRANSLOADIT_SECRET=... \ -- npx -y @transloadit/mcp-server stdio[mcp_servers.transloadit]command = "npx"args = ["-y", "@transloadit/mcp-server", "stdio"]enabled_tools = ["transloadit_list_templates"]gemini mcp add --scope user transloadit npx -y @transloadit/mcp-server stdio \ --env TRANSLOADIT_KEY=... \ --env TRANSLOADIT_SECRET=...{ "mcpServers": { "transloadit": { "command": "npx", "args": ["-y", "@transloadit/mcp-server", "stdio"], "env": { "TRANSLOADIT_KEY": "...", "TRANSLOADIT_SECRET": "..." }, "includeTools": ["transloadit_list_templates"] } }}{ "mcpServers": { "transloadit": { "command": "npx", "args": ["-y", "@transloadit/mcp-server", "stdio"], "env": { "TRANSLOADIT_KEY": "...", "TRANSLOADIT_SECRET": "..." } } }}{ "mcp": { "transloadit": { "command": "npx", "args": ["-y", "@transloadit/mcp-server", "stdio"], "env": { "TRANSLOADIT_KEY": "...", "TRANSLOADIT_SECRET": "..." } } }}export type InputFile = | { kind: 'base64' field: string base64: string filename: string contentType?: string } | { kind: 'url' field: string url: string filename?: string contentType?: string }type Attachment = { download_url: string file_id: string mime_type?: string file_name?: string}node scripts/verify-mcp-clients.tscorepack yarn installcorepack yarn --cwd packages/mcp-server checkcorepack yarn --cwd packages/mcp-server test:e2e