MCP Server

A video transcoding MCP server

Connect Transcodely to Claude, Claude Code, or Cursor and your agent can run real video work: submit an encode, ingest and host a file, generate captions, read back status and cost. 7 tools, one hosted URL, nothing to install. Transcodely is agent-native video infrastructure: the same encoding pipeline behind the REST API, exposed as tools your agent calls directly.

server · https://mcp.transcodely.com/mcp

MCP exchange streamable HTTP
  1. Tool call create_video_from_url tools/call
    {
      "url": "https://www.transcodely.com/videos/bbb-30s.mp4",
      "title": "Big Buck Bunny (30s)"
    }
  2. Result from create_video_from_url
    {
      "id": "vid_a1b2c3d4e5f6g7",
      "object": "video",
      "status": "processing",
      "visibility": "unlisted",
      "renditions": []
    }
  3. Tool call get_video tools/call
    { "id": "vid_a1b2c3d4e5f6g7" }
  4. Result from get_video
    {
      "id": "vid_a1b2c3d4e5f6g7",
      "object": "video",
      "status": "ready",
      "visibility": "unlisted",
      "duration_seconds": 30.0,
      "renditions": [
        { "resolution": "1080p", "codec": "h264" },
        { "resolution": "720p",  "codec": "h264" },
        { "resolution": "480p",  "codec": "h264" }
      ],
      "playback": {
        "player_url": "https://play.transcodely.com/v/vid_a1b2c3d4e5f6g7",
        "hls_url": "https://….b-cdn.net/…/hls/master.m3u8",
        "expires_at": "2026-08-18T18:00:00Z"
      }
    }
Tool names and argument keys are exactly what the protocol carries. Results are abridged and ids are examples; get_video is polled until the video is ready.
Connect

How do I connect Claude to video transcoding?

Three steps, and the only thing you type is a URL. The usual MCP setup — install a package, run it locally, paste an API key into a config file — is exactly what this isn’t.

  1. 01

    Point your client at the server

    One URL. There is no package to install, no gateway to run, and no local process to keep alive — the server is hosted and speaks MCP (Model Context Protocol) over streamable HTTP.

  2. 02

    Authorize

    Your client opens a browser window; you approve; it closes. No API key is created, copied, or pasted into a config file. If you do not have a Transcodely account yet, you can make one right there.

  3. 03

    Ask for a video

    The tools show up in your client. Describe what you want in plain language and the agent picks the tool, runs it against your app, and reports back.

  1. 1 Open Settings → Connectors → Add custom connector.
  2. 2 Paste the server URL: https://mcp.transcodely.com/mcp
  3. 3 Click Connect and approve the authorize screen.
https://mcp.transcodely.com/mcp

The same connector works in the Claude desktop and mobile apps.

Running headless, in CI, or on a server with no browser? Attach a Transcodely API key as a bearer token instead — the connect guide covers both paths.

Tools

What can an agent actually do?

Exactly 7 things. Three of them start billable work; the other four only read.

ToolWhat it doesEffect
create_video_from_urlIngest a publicly reachable https:// video and host it — adaptive ladder, CDN, player. Private and internal addresses are rejected.creates · billable
create_jobTranscode a source from gs://, s3://, or https:// into one or more renditions, written to a storage origin you own.creates · billable
generate_captionsTranscribe a hosted video into a WebVTT subtitle track. Idempotent per video and language, so a retry never bills twice.creates · billable
get_videoRead a hosted video: status, duration, every encoded rendition, and — once it is ready — the link to play it.read-only
get_job_statusA compact progress snapshot for one job — overall status, per-output status, and any error code. Built for polling.read-only
list_jobsRecent jobs newest first, optionally filtered by status, with cursor paging up to 100 rows per page.read-only
get_usageEncoding minutes, average storage, egress, and cost in EUR for a billing month, with a per-day breakdown.read-only
Guardrails

What keeps it safe?

Every call is scoped to one app

A tool call resolves to a single Transcodely app and sees only that app’s jobs and videos. Point separate connections at separate apps — a per-app URL each — to keep environments apart.

Every call is audited

Each tool call writes an audit row with the tool name and scrubbed arguments — the same audit trail your REST calls land in.

Limits

What it can’t do

A short surface is the point. Here is where it ends.

  • Nothing on this surface deletes or edits

    There is no delete, cancel, or update tool. An agent connected to Transcodely can create new work and read what exists — it cannot remove a video, kill a running job, or change a setting.

  • No file uploads over MCP

    create_video_from_url fetches a publicly reachable http(s) URL; private and internal addresses are rejected. To push bytes from your machine, use the dashboard or the upload API.

  • No admin, billing, or team surface

    Keys, members, plans, invoices, presets, and origins are not exposed. get_usage reports what a month cost; it cannot change what anything costs.

  • The encoder is not a model

    Transcoding is deterministic ffmpeg work — the same pipeline, the same output, whether an agent or a cron job starts it. generate_captions is the one genuinely AI feature here: speech transcribed into a WebVTT track.

FAQ

Frequently asked questions

Is there an MCP server for video transcoding?
Yes — Transcodely runs a hosted one at https://mcp.transcodely.com/mcp. It exposes 7 tools that submit real transcoding jobs, ingest and host videos, generate captions, and read back status, renditions, and monthly cost. It speaks MCP over streamable HTTP, so any client that supports remote MCP servers can use it without installing anything.
Which MCP clients work with it?
Anything that speaks remote MCP over streamable HTTP. We test claude.ai (including the Claude desktop and mobile apps), Claude Code, and Cursor. The server is a standard MCP endpoint — it has no client-specific behavior, so other clients that support remote servers work the same way.
How do I connect Claude Code to the Transcodely MCP server?
Run claude mcp add --transport http transcodely https://mcp.transcodely.com/mcp, then run /mcp inside Claude Code and pick Authenticate — your browser opens, you approve, and the tools are live.
Do I need an API key?
Not for the browser flow — you authorize the connection once and your client handles the rest. API keys are still the right choice for headless use: a CI job or a server-side agent with no browser attaches a Transcodely API key as a bearer token instead. Both paths are documented in the connect guide.
Can the agent delete my videos or cancel my jobs?
No — there is no delete, cancel, or update tool on this surface. Four of the seven tools only read; the other three create work: a transcoding job, a hosted video, or a caption track.
What does it cost to use?
The MCP server itself costs nothing. You pay the ordinary Transcodely rates for the work an agent starts — transcoding from €0.005 per output minute, hosting at €0.020/GB per month storage and €0.010/GB egress. Read-only tools are free to call.
Is the transcoding AI-powered?
No — encoding is deterministic ffmpeg work, the same pipeline the REST API drives. The one genuinely AI feature on this surface is generate_captions, which transcribes speech into a WebVTT subtitle track.
How do I cut off access?
Three ways, depending on what you need. Remove the connector in the client and that client stops calling tools. For a harder cut — someone leaving, or a connection you want gone rather than tidied up — an organization admin removes the member: membership is re-checked on every tool call, so access ends at their next request. On the headless path, revoke the API key and it stops working immediately. One caveat worth stating: an access token already issued stays valid until it expires, roughly ten minutes at worst, though no new one can be minted.

→ tools/call · connect · 2 min

Give your agent a video pipeline

Free to connect. You pay only for the encoding and hosting your agent actually starts — the same rates as the API.