# TubePull [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/miketwalker/tubepull-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tubepull-2

## Description
Download YouTube videos as MP3/M4A/MP4 from any MCP-compatible AI assistant. Free 3/day, $3.99/mo.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "tubepull": {
    "command": "npx",
    "args": ["-y","tubepull-2"]
  }
}
```

## Documentation & README

# TubePull MCP Server — Public Documentation

> 🌐 **Landing page**: [https://tubepull.com/mcp](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`](https://github.com/miketwalker/tubepull-mcp/blob/HEAD/AGENTS.md) and
[`llms.txt`](https://github.com/miketwalker/tubepull-mcp/blob/HEAD/llms.txt). If you are a human setting up Claude Desktop, jump to
[Quick start](#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](https://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`](https://github.com/miketwalker/tubepull-mcp/blob/HEAD/AGENTS.md) and the [`recipes/`](https://github.com/miketwalker/tubepull-mcp/blob/HEAD/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):

```json
{
  "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/<slug>"*
- *"download this Streamable: https://streamable.com/<slug>"*

---

## 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

```bash
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):

```bash
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.