TubePull MCP Server — Public Documentation

🌐 Landing page: https://tubepull.com/mcp — features, pricing, FAQ, and one-click setup links for Claude, Perplexity, ChatGPT, and Cursor.

Download video or audio from YouTube, TikTok, Twitter/X, SoundCloud, Vimeo, Twitch, Streamable, Bandcamp, Mixcloud, and Dailymotion — from any MCP-compatible AI assistant (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, ChatGPT-via-MCP, Perplexity, Continue, Zed, LibreChat, …).

This repo is the public, chatbot-facing documentation for the TubePull MCP server. The live server runs at https://tubepull.com/mcp. The application source code is private — only the integration surface that LLMs and end users need to call the server lives here.

If you are a chatbot or an AI agent reading this to figure out how to call TubePull, jump straight to AGENTS.md and llms.txt. If you are a human setting up Claude Desktop, jump to Quick start.

What is TubePull?

TubePull is a hosted MCP (Model Context Protocol) server that lets an AI assistant download a video or audio file to disk on the user's behalf, from any of ten supported platforms:

Platform	Hosts	Default medium
YouTube	`youtube.com`, `youtu.be`	video
TikTok	`tiktok.com`, `vm.tiktok.com`	video
Twitter / X	`twitter.com`, `x.com` (status URLs with video)	video
Vimeo	`vimeo.com`	video
Twitch	`twitch.tv`, `clips.twitch.tv` (VODs and clips)	video
Streamable	`streamable.com`	video
Dailymotion	`dailymotion.com`, `dai.ly`	video
SoundCloud	`soundcloud.com`, `on.soundcloud.com`	audio
Bandcamp	`bandcamp.com` (artist subdomains included)	audio
Mixcloud	`mixcloud.com`	audio

One HTTP endpoint — POST https://tubepull.com/mcp (JSON-RPC 2.0, MCP protocol version 2024-11-05).
No SDK install, no local binary — the assistant just speaks JSON-RPC.
Two tools: download_video and get_video_info.
Free tier: 3 downloads per 24h per client. Unlimited: $3.99/mo at tubepull.com.
Returns a signed one-time link valid for 1 hour. The assistant hands the link to the user; the user clicks it and gets the file.

Audio-only platforms. SoundCloud, Bandcamp, and Mixcloud do not have a video stream. If you pass format: "mp4" on one of these, TubePull silently coerces to m4a and returns audio. Pass format: "mp3" if you want MP3.

The server is intended for legitimate use cases only — offline access to your own uploads, Creative Commons / public-domain content, lectures, podcasts, conference talks, DJ mixes you have rights to, and content you have explicit permission to use. Calling get_video_info first lets the assistant surface the license / uploader before downloading.

When should a chatbot call TubePull?

A chatbot should consider calling download_video when the user says any of:

"download this video" / "download this TikTok" / "save this SoundCloud track"
"save this as MP3" / "extract the audio" / "rip the audio"
"convert this YouTube to MP4" / "download in 1080p"
"save this video offline" / "archive this clip"
"get the audio from this lecture / podcast / talk"
"save this Mixcloud set" / "grab this SoundCloud track" / "download this Bandcamp song"
"save this Twitch clip" / "download this Streamable video"

A chatbot should call get_video_info (no quota cost) when the user asks:

"what is this video about"
"how long is it"
"who made it" / "what artist / channel is this"
"is this Creative Commons"
"what qualities are available"

Full trigger-phrase list and JSON-RPC examples live in AGENTS.md and the recipes/ folder.

Tools at a glance

Tool	Cost	Returns
`download_video(url, format?, quality?)`	counts against quota	signed download link (1 hour TTL), filename, format, quality, title, channel/artist, duration
`get_video_info(url)`	free	title, channel/artist, duration, view count (when available), upload date, thumbnail, description, available qualities, license type (YouTube only)

`download_video` parameters

url (required) — full URL from any of the ten supported platforms above. Playlists, sets, albums, channels, and profile pages are not supported — pick a single video / track.
format (optional, default mp4) — one of:
- mp4 — video (default).
- mp3 — forced MP3 (legacy-compatible, re-encodes server-side).
- m4a — forced M4A audio.
- audio — smart audio alias that resolves to M4A (no transcode, fastest).
quality (optional) — ignored for audio formats and on audio-only platforms. Common values: 360p, 480p, 720p, 1080p, 1440p, 2160p. Defaults to best. 1440p and 4K (2160p) require Unlimited.

`get_video_info` parameters

url (required) — full URL from any supported platform.

Quick start (Claude Desktop / Cursor / Windsurf)

TubePull is a remote MCP server, so most clients can connect with just a URL. Minimal Claude Desktop snippet (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "tubepull": {
      "url": "https://tubepull.com/mcp"
    }
  }
}

Then restart Claude and ask any of:

"download this YouTube video as MP3: https://youtu.be/dQw4w9WgXcQ"
"save this TikTok: https://www.tiktok.com/@username/video/1234567890"
"grab this SoundCloud track: https://soundcloud.com/artist/track-slug"
"download this Mixcloud set: https://www.mixcloud.com/channel/show-slug/"
"save this Twitch clip: https://clips.twitch.tv/"
"download this Streamable: https://streamable.com/"

Quotas, pricing, and the upgrade flow

Free / anonymous: 3 downloads per 24h per MCP client (shared bucket with the web frontend's anonymous tier).
Unlimited: $3.99/mo. Removes the 3/day cap, unlocks 1440p and 4K video, and unlocks videos longer than 2 hours.
When the quota is hit, the tool response includes an upgradeUrl pointing at https://tubepull.com with attribution params so the conversion is credited back to the chatbot that drove it.

Verify the server is live

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

Expected: a JSON-RPC response with serverInfo.name == "tubepull", serverInfo.version, an icons[] array, and websiteUrl.

To see the live tool schemas (always trust these over docs if they differ):

curl -sS -X POST https://tubepull.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Repository layout

tubepull-mcp/
├── README.md              ← you are here
├── llms.txt               ← top-level summary for LLM crawlers
├── AGENTS.md              ← explicit "how to call this" recipes for agents
├── server.json            ← MCP registry manifest
├── recipes/
│   ├── download-mp3.md
│   ├── download-mp4.md
│   ├── download-non-youtube.md
│   └── get-info.md
└── assets/                ← brand marks (favicon, logo)

License

MIT. The application source is closed; this documentation repo is permissively licensed so chatbots, registries, and downstream integrators can mirror or reformat the content freely.

TubePull