Skip to content

transloadit/node-sdk

Repository files navigation

Build Status Coverage

Transloadit Logo

Transloadit JavaScript/TypeScript SDKs

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

Packages

  • @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.