# Transloadit — how to use (mcp.ai)

Connect your Transloadit account and use 6 tools for file management and storage straight from your AI agent. Connect with your own API key. Transloadit is a cloud platform for uploading, transforming, and delivering files, images, audio, and video through programmable processing workflows.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_transloadit?ms=1787291160000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `transloadit_cancel_assembly`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/transloadit`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/transloadit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/transloadit/cancel/assembly` — Cancel a running Assembly and any upload still in progress. Fails if the Assembly reaches another terminal state before cancellation is confirmed.
  - body: { assembly_id: string }
- `POST https://api.mcp.ai/api/transloadit/create/assembly` — Start a Transloadit file-processing Assembly from validated inline Steps or an existing Template, optionally uploading up to 10 local files with a 20 MiB aggregate direct-upload limit. Use a /http/imp
  - body: { files?: object[], steps?: object, fields?: object, notify_url?: string, template_id?: string, allow_steps_override?: boolean }
- `POST https://api.mcp.ai/api/transloadit/get/assembly/status` — Retrieve the latest state, uploads, warnings, and results for one Assembly. This performs one status fetch and does not poll. Transloadit limits status requests to 3 per second for the same Assembly I
  - body: { assembly_id: string }
- `POST https://api.mcp.ai/api/transloadit/list/assemblies` — Return one page of Assemblies in descending creation order, optionally filtered by state, date range, or keywords.
  - body: { type?: string, to_date?: string, keywords?: string[], from_date?: string, page_size?: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/transloadit/replay/assembly` — Retry a crashed Assembly while its original input files remain recoverable, optionally reparsing its Template.
  - body: { assembly_id: string, reparse_template?: boolean }
- `POST https://api.mcp.ai/api/transloadit/replay/assembly/notification` — Resend a completed Assembly's result notification to the notify_url configured on that Assembly.
  - body: { assembly_id: string }

## Example prompts
- "What can I do in Transloadit?"
- "Show me a summary of my Transloadit account"

## More
- Page: https://mcp.ai/transloadit
- Agent spec (llms.txt): https://mcp.ai/transloadit/llms.txt
- Postman collection: https://mcp.ai/transloadit/postman.json