# transloadit/node-sdk [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/transloadit/node-sdk/tree/main/packages/mcp-server  
**GitHub Stars:** 73  
**npm Downloads (last month):** 2283  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/transloadit-node-sdk

## Description
Agent-native media processing via Transloadit's 86+ Robots: video encoding (HLS, H.264, VP9), image manipulation (resize, watermark, smart crop), document conversion, OCR, speech transcription, and more. Hosted or self-hosted via npx.

## Tools
Capabilities this server exposes over MCP:

- **transloadit_lint_assembly_instructions** — read-only
- **transloadit_list_robots** — read-only
- **transloadit_get_robot_help** — read-only
- **transloadit_create_assembly** — destructive, open-world (URL imports), widget
- **transloadit_get_assembly_status** — read-only
- **transloadit_wait_for_assembly** — read-only, result widget
- **transloadit_list_templates** — read-only
- **transloadit_get_profile** — read-only, `_meta["openai/profile"]

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "node-sdk": {
    "command": "npx",
    "args": ["-y","@transloadit/mcp-server"],
    "env": {
      "TRANSLOADIT_KEY": "",
      "TRANSLOADIT_SECRET": "",
      "TRANSLOADIT_SIGNATURE_ALGORITHM": "",
      "TRANSLOADIT_MCP_TOKEN": "",
      "TRANSLOADIT_MCP_RESOURCE_METADATA_URL": ""
    }
  }
}
```

**Requires environment variables:** `TRANSLOADIT_KEY`, `TRANSLOADIT_SECRET`, `TRANSLOADIT_SIGNATURE_ALGORITHM`, `TRANSLOADIT_MCP_TOKEN`, `TRANSLOADIT_MCP_RESOURCE_METADATA_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/transloadit-node-sdk/readme_