{
  "markdown": "# Transcodely MCP Server\n\n**Video transcoding and hosting for AI agents, over the [Model Context Protocol](https://modelcontextprotocol.io).**\n\n[![smithery badge](https://smithery.ai/badge/transcodely/video)](https://smithery.ai/servers/transcodely/video)\n[![transcodely/mcp MCP server](https://glama.ai/mcp/servers/transcodely/mcp/badges/score.svg)](https://glama.ai/mcp/servers/transcodely/mcp)\n\nTranscodely is agent-native video infrastructure: transcode, host, and get a playable link back from one natural-language prompt. Connect with one OAuth click — no API key to create or paste — then hand your agent a video URL.\n\n- **Server URL (streamable HTTP):** `https://mcp.transcodely.com/mcp`\n- **Product page:** https://www.transcodely.com/mcp\n- **Connect guide:** https://www.transcodely.com/docs/guides/mcp\n- **Registry identifier:** `com.transcodely/mcp`\n\n> This is the public home of the hosted server: connect instructions, the tool surface, and the registry manifest. The server itself is a hosted service — there is nothing to install or run.\n\n## Connect\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http transcodely https://mcp.transcodely.com/mcp\n```\n\nThen run `/mcp` inside Claude Code and pick **Authenticate** — your browser opens, you approve, and the tools are live. No Transcodely account yet? One is created for you during authorization.\n\n**claude.ai / Claude desktop** — Settings → Connectors → Add custom connector → `https://mcp.transcodely.com/mcp`.\n\n**Cursor** — add to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"transcodely\": { \"type\": \"http\", \"url\": \"https://mcp.transcodely.com/mcp\" }\n  }\n}\n```\n\nAny other client that supports remote MCP servers over streamable HTTP works the same way. For headless use (CI, server-side agents), attach a Transcodely API key as a bearer token instead — see the [connect guide](https://www.transcodely.com/docs/guides/mcp).\n\n## Tools (7)\n\n| Tool | Effect |\n|---|---|\n| `create_video_from_url` | Ingest an `https://` video, transcode it into an adaptive ladder, host it — returns a video that becomes playable when ready |\n| `create_job` | Create a transcoding job writing renditions to a storage origin you own |\n| `generate_captions` | AI captions (WebVTT) for a hosted video; idempotent per video + language |\n| `get_video` | Status, renditions, and the playable link for a hosted video |\n| `get_job_status` | Concise job status/progress snapshot, built for polling |\n| `list_jobs` | Jobs for the authenticated app, newest first, with pagination |\n| `get_usage` | Usage and cost for a billing month, per-line and total, in EUR |\n\nNothing on this surface deletes or modifies existing data: four tools only read, three create work.\n\n## Try it\n\n1. *\"Transcode and host this video and give me a link: https://www.transcodely.com/videos/bbb-30s.mp4\"*\n2. *\"Generate English captions for that video.\"*\n3. *\"What's the status of my last job?\"*\n4. *\"How much have I spent on video this month, and which day cost the most?\"*\n\n## Run locally (stdio bridge)\n\nRemote-capable clients should connect straight to the hosted endpoint above — that's the\none-click OAuth path. For stdio-only clients, sandboxes, and headless use, this repo is\nalso a runnable bridge that serves the same 7 tools over stdio and forwards calls to the\nhosted server:\n\n```bash\n# with an API key (create one in the Transcodely dashboard):\nTRANSCODELY_API_KEY=ak_... npx github:transcodely/mcp\n\n# or via Docker:\ndocker build -t transcodely-mcp .\ndocker run -i --rm -e TRANSCODELY_API_KEY=ak_... transcodely-mcp\n```\n\nWithout `TRANSCODELY_API_KEY` the bridge still starts and answers introspection\n(`initialize`, `tools/list`); tool calls return an error pointing at the two auth paths.\n`tools.json` is generated from the hosted server's own `tools/list` response and is\nre-vendored on every server release that changes the tool surface.\n\n## Auth and guardrails\n\n- OAuth 2.1 with PKCE via browser consent; the server implements RFC 9728 Protected Resource Metadata and RFC 8707 resource indicators.\n- Every tool call is scoped to a single Transcodely app and writes the same audit trail as REST calls.\n- The MCP server is free to connect; work an agent starts is billed at [the ordinary Transcodely rates](https://www.transcodely.com/pricing). Read-only tools are free to call.\n\n## Manifest\n\n[`server.json`](./server.json) is the manifest published to the official MCP registry.\n",
  "bytes": 4419,
  "sha": "85f0c09ddabdc4c9e08e1037be7aa49b623975038bf34d0ff17d4598ae50b764",
  "repo_slug": "transcodely/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_transcodely_mcp_23e7f4f5/readme"
}