Repository avatar
Multimedia
v1.1.0
active

mcp

io.github.Tube2Vid/mcp

Download video, audio and images from YouTube, TikTok, Instagram and 1,800+ sites.

Documentation

Tube2Vid MCP Server

CI npm License: MIT

A YouTube, TikTok and Instagram video downloader for AI agents. @tube2vid/mcp is a Model Context Protocol server that lets Claude Desktop, Claude Code, Cursor and any other MCP client download video, audio and images from YouTube, TikTok, Instagram, X, Reddit and 1,800+ other sites through the Tube2Vid download API. Ask "save this TikTok as MP4" or "get the audio of this YouTube video as MP3" and the model queues the job, waits for it and hands back a download link.

Tools

ToolWhat it doesNeeds a key
list_supported_platformsFirst-class platforms and their capabilitiesno
get_platform_healthLive per-platform statusno
get_account_usageCredit balance and job countsyes
submit_download_jobQueue a download (url, mode, format, quality)yes
get_job_statusProgress and result of a jobyes
get_download_linkShort-lived direct link to a finished fileyes

Setup

Get an API key with the jobs:write, jobs:read and usage:read scopes (the defaults). Use a separate key for MCP so you can revoke it on its own. Needs Node 18.17+.

Claude Desktop

Add this to claude_desktop_config.json (Settings, Developer, Edit Config):

{
  "mcpServers": {
    "tube2vid": {
      "command": "npx",
      "args": ["-y", "@tube2vid/mcp"],
      "env": { "TUBE2VID_API_KEY": "tv_live_..." }
    }
  }
}

Claude Code

claude mcp add tube2vid --env TUBE2VID_API_KEY=tv_live_... -- npx -y @tube2vid/mcp

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "tube2vid": {
      "command": "npx",
      "args": ["-y", "@tube2vid/mcp"],
      "env": { "TUBE2VID_API_KEY": "tv_live_..." }
    }
  }
}

Any other client

Run npx -y @tube2vid/mcp (or npm install -g @tube2vid/mcp, then tube2vid-mcp) as a stdio server. The server is also listed in the MCP registry as io.github.Tube2Vid/mcp.

Configuration

VariableDefault
TUBE2VID_API_KEYnoneYour tv_live_... key
TUBE2VID_API_URLhttps://tube2vid.comAPI origin
MCP_TRANSPORTstdiohttp serves Streamable HTTP on POST /mcp instead
PORT8000Port for http mode

In http mode every caller shares the one configured key, so only expose it to clients you trust.

Links

SDKs in other languages: TypeScript, Python, Go, Java, C#, PHP, Ruby, Rust, Swift.

Develop

npm install
npm test        # in-memory MCP client against a fake API
npm run dev     # stdio, from source
npm run build   # compiles to dist/

When you bump the version, update package.json and both versions in server.json together; the release workflow checks that they match the tag.

License

MIT, Copyright (c) 2026 Tube2Vid.

NPM
@tube2vid/mcp
Install Command
npm install @tube2vid/mcp