README.md
Agent-native media processing via 86+ cloud Robots.
<source media="(prefers-color-scheme: dark)" srcset="https://assets.transloadit.com/assets/images/sponsorships/logo-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://assets.transloadit.com/assets/images/sponsorships/logo-default.svg">
Transloadit JavaScript/TypeScript SDKs
Monorepo for Transloadit SDKs, shared packages, and the MCP server.
Packages
@transloadit/node— Node.js SDK + CLI. Seepackages/node/README.md.transloadit— Stable unscoped package (built from@transloadit/node).@transloadit/mcp-server— MCP server (Streamable HTTP + stdio). Seepackages/mcp-server/README.md.@transloadit/types— Shared TypeScript types.@transloadit/utils— Shared utilities.@transloadit/zod— Zod schemas for Transloadit APIs.
Quick start
Node SDK
import { Transloadit } from '@transloadit/node'
const client = new Transloadit({
authKey: process.env.TRANSLOADIT_KEY as string,
authSecret: process.env.TRANSLOADIT_SECRET as string,
})
const result = await client.createAssembly({
params: {
steps: {
':original': { robot: '/upload/handle' },
},
},
files: { file: '/path/to/file.jpg' },
waitForCompletion: true,
})
MCP server
See packages/mcp-server/README.md for MCP setup, auth, and tool docs.
Development
- Install:
corepack yarn - Checks + unit tests:
corepack yarn check - Node SDK unit tests:
corepack yarn workspace @transloadit/node test:unit
Repo notes
- Docs live under
docs/(non-MCP). - The
transloaditpackage is prepared viascripts/prepare-transloadit.ts.
Tools (1)
createAssemblyCreates a new assembly to process files using Transloadit robots.Environment Variables
TRANSLOADIT_KEYrequiredYour Transloadit API authentication key.TRANSLOADIT_SECRETrequiredYour Transloadit API authentication secret.Configuration
claude_desktop_config.json
{"mcpServers": {"transloadit": {"command": "npx", "args": ["-y", "@transloadit/mcp-server"], "env": {"TRANSLOADIT_KEY": "your_key", "TRANSLOADIT_SECRET": "your_secret"}}}}Try it
→Create an assembly to resize the image at /path/to/image.jpg to 800x600 pixels.
→Transcribe the audio file located at /path/to/audio.mp3 using the Transloadit assembly tool.
→Convert the document at /path/to/file.docx into a PDF format.
→Encode the video file at /path/to/video.mov into an MP4 format for web streaming.