TubePull

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, Facebook, Instagram, Reddit, 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, and canonical machine-readable product facts are published at https://tubepull.com/facts (https://tubepull.com/facts.json). 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 13 supported platforms (YouTube plus 12 more platforms, including Streamable):

Platform	Hosts	Default medium
YouTube	youtube.com, youtu.be	video
TikTok	tiktok.com, vm.tiktok.com, vt.tiktok.com	video
Facebook	facebook.com, fb.watch	video
Instagram	instagram.com (public reels, video, photos)	video
Reddit	reddit.com, redd.it, v.redd.it (account link)	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 (Streamable HTTP / 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 rolling 24h per client, up to 1080p Full HD and up to 1 hour of output length. Pro: $4.99/month ($47.88/year, $3.99/mo billed annually) at tubepull.com/pricing.
• 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 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 TubePull Pro.

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 rolling 24h per MCP client (shared bucket with the web frontend's anonymous tier), up to 1080p Full HD and up to 1 hour of output length.
• TubePull Pro: $4.99/month ($47.88/year, $3.99/month billed annually). Removes the 3/day cap for normal personal use, unlocks 1440p (2K) and 4K (2160p) video plus 320 kbps MP3, and lifts the 1-hour output-length cap.
• Authentication: Supports unauthenticated Free-tier access, OAuth 2.1 + PKCE (/.well-known/oauth-authorization-server) for Pro accounts, and legacy X-MCP-Client-Id headers. See https://tubepull.com/setup-mcp.
• 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)

---

Links

• Live MCP endpoint — https://tubepull.com/mcp
• Web app — https://tubepull.com
• MCP spec — https://modelcontextprotocol.io
• mcp.so listing — https://mcp.so (search "tubepull")

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.