transloadit/node-sdk

Build Status Coverage

Transloadit JavaScript/TypeScript SDKs

Monorepo for Transloadit SDKs, shared packages, and the MCP server.

Transloadit Server MCP server

Packages

• @transloadit/viewer — Published alpha for responsive images from Storage and Smart CDN Templates. See the Viewer guide.
• @transloadit/node — Node.js SDK + CLI. See packages/node/README.md.
• transloadit — Stable unscoped package (built from @transloadit/node).
• @transloadit/mcp-server — MCP server (Streamable HTTP + stdio). See packages/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 transloadit package is prepared via scripts/prepare-transloadit.ts.
• PR checks enforce that tracked files in packages/transloadit/ stay in sync with @transloadit/node.
• Tarball fingerprint parity remains available as a manual release/debug tool via corepack yarn parity:transloadit.