Log inSubmit server
Node Sdk logo

Node Sdk

by transloadit

Run Transloadit media workflows through MCP, from Robot discovery and linting to assembly creation and status tracking.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Node Sdk

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "transloadit-node-sdk": {
      "command": "npx",
      "args": [
        "-y",
        "@transloadit/mcp-server"
      ],
      "env": {
        "TRANSLOADIT_KEY": "YOUR_VALUE_HERE",
        "TRANSLOADIT_SECRET": "YOUR_VALUE_HERE",
        "TRANSLOADIT_SIGNATURE_ALGORITHM": "YOUR_VALUE_HERE",
        "TRANSLOADIT_MCP_TOKEN": "YOUR_VALUE_HERE",
        "TRANSLOADIT_MCP_RESOURCE_METADATA_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @transloadit/mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 5d ago.

Overview

transloadit/node-sdk MCP server exposes Transloadit's media-processing API through hosted Streamable HTTP or local stdio. Agents can inspect Robot capabilities, lint Assembly instructions, manage templates, create Assemblies, and monitor results. The hosted endpoint uses OAuth, while self-hosted deployments authenticate with Transloadit credentials. Reach for it when an agent needs to encode, transform, convert, transcribe, or otherwise process media through Transloadit's Robots.

Use cases

  • Encode videos into HLS, H.264, or VP9 outputs
  • Resize, watermark, or smart-crop images
  • Convert documents and run OCR
  • Transcribe speech from media files
  • Create and monitor Transloadit Assemblies

Key features

  • Transloadit Robot discovery and help
  • Assembly instruction linting
  • Assembly creation with URL imports
  • Assembly status polling and waiting
  • Template listing and profile retrieval
  • Hosted OAuth and self-hosted credential authentication

Tools8

What Node Sdk lets your agent do. Expand a tool for its parameters.

Self-reported~93 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

14/15 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @transloadit/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars73Stargazers on the source repository.
npm downloads2.3kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed8Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Node Sdk works

What transloadit/node-sdk does

Transloadit/node-sdk MCP server connects MCP clients to Transloadit's Assembly and Robot APIs. It gives agents access to more than 86 media-processing Robots for tasks such as video encoding, image manipulation, document conversion, OCR, and speech transcription. Supported workflows include HLS, H.264, VP9, resizing, watermarking, and smart cropping.

The tool set also covers the surrounding workflow: discovering available Robots, reading Robot-specific help, checking Assembly instructions, listing saved Templates, creating Assemblies, and retrieving or waiting for Assembly status. Assembly creation can import files from URLs, so it is a state-changing operation with open-world input behavior.

How it works

The package supports two MCP transports. A hosted Streamable HTTP endpoint is available at https://api2.transloadit.com/mcp; MCP clients authenticate there through OAuth and a browser consent flow. Robot documentation and instruction linting require no scopes, while processing operations use the authenticated Transloadit account.

For local operation, install the npm package and launch its stdio or HTTP entry point with npx. The server signs API requests using a Transloadit Auth Key and Secret. HTTP deployments bound beyond localhost also use a separate transport token to protect the MCP endpoint. Docker images are available for containerized stdio or HTTP deployments.

Setup and configuration

Install the package with:

Terminal
npm install @transloadit/mcp-server

A self-hosted stdio process can be started with:

bash
TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server stdio

HTTP mode accepts host and port options:

bash
TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY npx -y @transloadit/mcp-server http --host 127.0.0.1 --port 5723

Use TRANSLOADIT_SIGNATURE_ALGORITHM=sha256 for Auth Keys configured for SHA-256 signing; other keys use SHA-384 by default. A non-local HTTP listener must also set TRANSLOADIT_MCP_TOKEN, then clients send that value as a bearer token. This token protects the local MCP transport and is separate from API2 bearer tokens.

Headless environments can mint an API2 bearer token from an Auth Key and Secret with npx -y @transloadit/node auth token --aud mcp. Interactive users can instead use the Transloadit CLI device login. The hosted endpoint can be added directly by URL in supported MCP clients.

Tools and capabilities

Available tools include:

  • transloadit_lint_assembly_instructions for read-only Assembly instruction checks.
  • transloadit_list_robots and transloadit_get_robot_help for Robot discovery and documentation.
  • transloadit_create_assembly to start a Transloadit Assembly.
  • transloadit_get_assembly_status and transloadit_wait_for_assembly to inspect or await processing results.
  • transloadit_list_templates to retrieve available Templates.
  • transloadit_get_profile to retrieve profile data, including an OpenAI profile metadata field.

The wait operation can return an Assembly result widget, and files attached in ChatGPT are passed to Assembly creation as attachments.

Limitations and notes

Hosted use requires signing in before tools run, except that Robot documentation and linting do not require scopes. Self-hosting is the option for using those tools without an account-based hosted session. Invalid signing algorithms produce an mcp_invalid_signature error, while rejected self-hosted credentials produce mcp_credentials_rejected.

The hosted service challenges unauthenticated requests, including a basic endpoint probe, with OAuth metadata. Self-hosted HTTP deployments require careful handling of the transport token when exposed beyond loopback. Assembly creation may access URL imports and should be treated as a destructive, open-world tool.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Node Sdk

transloadit/node-sdk is an MCP server that connects AI agents to Transloadit's media-processing API. Its main tools discover Robots, read Robot help, lint Assembly instructions, create Assemblies, list Templates, retrieve profiles, and check or await Assembly status across hosted HTTP or self-hosted stdio deployments.

Install it with `npm install @transloadit/mcp-server`, then start stdio with `npx -y @transloadit/mcp-server stdio`. Set `TRANSLOADIT_KEY` and `TRANSLOADIT_SECRET` for self-hosted authentication. You can also run the published Docker image or connect to the hosted endpoint by URL.

Yes, transloadit/node-sdk works with Cursor over either the hosted HTTP endpoint or local stdio. Add the hosted URL to `~/.cursor/mcp.json`, or configure the stdio command with `TRANSLOADIT_KEY`, `TRANSLOADIT_SECRET`, and `npx -y @transloadit/mcp-server stdio`.

Use a bearer token minted for the `mcp` audience. The Transloadit CLI can create one with `npx -y @transloadit/node auth token --aud mcp`, and the token can then be supplied to the agent runtime. Self-hosted stdio can instead use the Transloadit Auth Key and Secret environment variables.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNode Sdk AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/transloadit-node-sdk?style=directory)](https://allmcps.com/mcp/transloadit-node-sdk)
HTML Embed
<a href="https://allmcps.com/mcp/transloadit-node-sdk"><img src="https://allmcps.com/api/badge/transloadit-node-sdk?style=directory" alt="Node Sdk on AllMCPs" /></a>