# Transcodely [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/transcodely/mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/transcodely

## Description
Transcode and host video from one prompt; get a playable link back. Agent-native, over MCP.

## Tools
Capabilities this server exposes over MCP:

- **create_job** — Create a transcoding job.
- **create_preset** — Create a custom encoding preset for this app: a named, reusable bundle of encoding settings that create_job can reference by slug.
- **create_video_from_url** — Ingest a remote https:// video and host it in one call — this is the tool for "transcode and host this, give me a link".
- **generate_captions** — Generate AI captions (subtitles) for a hosted video by id (vid_...).
- **get_ingest_rule** — Fetch one ingest rule by id (ing_...): its origin, enabled state, filters, the job it submits, and its event/job counts.
- **get_job_status** — Get a concise status snapshot for a transcoding job by id (job_...): overall status and progress, any error code/message, and per-output status/progress with errors.
- **get_output_report** — Get the full measurement report for one job output (job_... plus out_...): what the produced file turned out to BE, measured from the written file, and the verdict of comparing that against what the job asked for.
- **get_usage** — Return hosting usage and cost for a billing month: videos encoded, encoding minutes, average storage, egress, request counts, and per-line and total cost in EUR.
- **get_video** — Fetch a hosted video by id (vid_...): status, visibility, title, duration, poster image, encoded renditions (resolution, codec, bitrate, dimensions), and — once status is "ready" — a playback block.
- **list_ingest_events** — List the storage deliveries this app's ingest rules received, newest first, with what became of each: the bucket and object key, the outcome (received, matched, created, skipped or failed), the REASON for a skip or failure, and the job id when one was created.
- **list_ingest_rules** — List this app's ingest rules: the standing instructions that turn an object landing in a storage origin into a transcoding job.
- **list_jobs** — List transcoding jobs for the authenticated app, newest first.
- **list_presets** — List the encoding presets available to this app: the read-only ones the platform ships and the app's own custom ones.
- **set_spend_limit** — Set or clear this app's monthly transcoding spend limit, in EUR.
- **update_preset** — Update a custom preset's settings by id (pst_...).

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

```json
"mcpServers": {
  "transcodely": {
    "command": "npx",
    "args": ["-y","github:transcodely/mcp"]
  }
}
```

## Documentation

## What Transcodely MCP server does

The Transcodely MCP server provides an agent-facing video pipeline over Model Context Protocol. An agent can submit a remote HTTPS video for transcoding and hosting in one operation, then retrieve a playable link after processing. It can also create jobs directly, generate AI captions for hosted videos, and inspect the resulting media.

The service is scoped to one Transcodely app per session. Jobs, videos, presets, and ingest rules belonging to another app are not exposed through the tool surface. The server also records an audit trail for tool calls equivalent to the corresponding REST operations.

## How it works

Connect to the hosted streamable HTTP endpoint at `https://mcp.transcodely.com/mcp`. Browser-based clients use OAuth 2.1 with PKCE, and the session determines the app scope. The bare endpoint resolves to the organization’s oldest active app; an app-specific URL can pin the connection to a particular app.

For headless or server-side agents, the connection guide supports sending a Transcodely API key as a bearer token. Three operations start billable work: `create_job`, `create_video_from_url`, and `generate_captions`. Preset creation, reads, reporting, and spend-limit changes do not themselves incur those processing charges.

## Setup and configuration

The Transcodely MCP server is hosted, so there is no local service to install or run. In Claude Code, add the HTTP server with:

```bash
claude mcp add --transport http transcodely https://mcp.transcodely.com/mcp
```

Authenticate through the browser when prompted. In Claude desktop, add the same URL as a custom connector. In Cursor, add an HTTP MCP entry pointing to the endpoint in `~/.cursor/mcp.json`. Other clients can connect if they support remote MCP servers over streamable HTTP.

The `set_spend_limit` tool can set or clear a monthly transcoding limit in EUR, but it requires an organization owner or admin using browser OAuth. API-key sessions cannot use this tool.

## Tools and capabilities

Available operations include:

- Create transcoding jobs and reusable custom encoding presets.
- Ingest and host an HTTPS video with `create_video_from_url`.
- Generate captions for a hosted video.
- List jobs, presets, ingest rules, and ingest events.
- Read job progress, per-output status, playback information, and encoded renditions.
- Compare a written output against the job request with `get_output_report`.
- Review monthly encoding, storage, egress, request, and EUR cost data.
- Update custom presets and configure the monthly spend limit.

Ingest rules describe how storage objects become transcoding jobs. Ingest-event results include the bucket, object key, outcome, reason for skips or failures, and any created job ID.

## Limitations and notes

The Transcodely MCP server has no delete, cancel, remove, purge, rotate, or destroy tools. Agents cannot remove videos, jobs, outputs, presets, or rules, and cannot stop queued or running work. It also does not expose API keys, inbound ingest secrets, organization members, plans, invoices, team settings, or other administrative data.

Editing a preset affects jobs created afterward because presets are expanded when a job starts; existing jobs are unchanged. Lowering a spend limit blocks a later job but does not stop work already in progress. The MCP connection itself is free, while processing charges follow Transcodely’s ordinary rates.

_Full upstream README: https://allmcps.com/mcp/transcodely/readme_