{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_h5jv2r9gx9sx","handle":"mcp-youtube","url":"https://wellknown.network/agents/mcp-youtube","links":{"self":"https://wellknown.network/agents/mcp-youtube/record.json","html":"https://wellknown.network/agents/mcp-youtube","markdown":"https://wellknown.network/agents/mcp-youtube/record.md","api":"https://wellknown.network/api/v1/agents/mcp-youtube","status":"https://wellknown.network/api/v1/agents/mcp-youtube/status","claim":"https://wellknown.network/agents/mcp-youtube/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-youtube/claim.json","badge":"https://wellknown.network/agents/mcp-youtube/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-youtube/history","tools":"https://wellknown.network/api/v1/agents/mcp-youtube/tools"},"ard":{"identifier":"urn:air::server:mcp-youtube","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-youtube","summary":"MCP server wrapping yt-dlp for video/audio/subtitle download via FastMCP","description":"# MCP‑YouTube 🚀\n\n[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)\n[![yt‑dlp](https://img.shields.io/badge/Powered%20by-yt--dlp-red)](https://github.com/yt-dlp/yt-dlp)\n\n**MCP‑YouTube** exposes the power of [yt‑dlp](https://github.com/yt-dlp/yt-dlp) as a [Model Context Protocol (MCP)](#about-mcp) server – download videos, playlists, audio, subtitles and more through a single JSON call.\n\n---\n\n## ✨ Highlights\n\n• **Drop‑in server** – start it and invoke high‑level tools immediately  \n• **Works with any MCP client**: CLI, Cursor (VS Code), Claude Desktop, HTTP fetchers, ChatGPT plug‑ins & more  \n• **Rich logs** – progress, speed, ETA and errors stream back to the caller  \n• **Fully async** – multiple downloads at once without blocking  \n\n---\n\n## 🗒️ Requirements\n\n| Component | Why it's needed | Install (macOS / Ubuntu / Windows) |\n|-----------|----------------|-----------------------------------|\n| **Python 3.8+** | Runs the MCP‑YouTube server | Built‑in / `brew install python` / `sudo apt install python3` / <https://www.python.org/downloads/> |\n| **ffmpeg** | Used by yt‑dlp to merge video & audio, extract audio, convert thumbnails | `brew install ffmpeg` / `sudo apt install ffmpeg` / `choco install ffmpeg` |\n| **yt‑dlp** | Core downloader library | Installed automatically via `uv sync` or `pip install -e .[all]` |\n\n*If you use the provided Docker image, both `yt-dlp` and `ffmpeg` are already included.*\n\n---\n\n## ⚡️ Quick Start\n\n```bash\n# 1. Create & activate a virtualenv (using uv)\nuv venv && source .venv/bin/activate\n\n# 2. Install project dependencies\nuv sync   # reads pyproject / uv.lock\n\n# 3. Run the server (STDIO transport)\nuv run python mcp_youtube.py\n```\n\nThe banner should show:\n```text\n✔ FastMCP server \"mcp-youtube\" is ready (stdio)\n```\n> Hot‑reload for development: `uv run dev python mcp_youtube.py`\n\n---\n\n## 🛠️ Available Tools\n\n| Tool | Purpose |\n|------|---------|\n| `download_video` | Download a single video (select quali…","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-youtube","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.video-editing","name":"Video Editing","confidence":0.814,"provenance":"derived"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-youtube","registry":"pypi","observedAt":"2026-11-03T17:26:02.631Z","publishedAt":"2025-04-21T14:28:26.124408Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-youtube","url":"https://pypi.org/project/mcp-youtube/","firstSeenAt":"2026-09-10T05:22:21.861Z","fetchedAt":"2026-11-03T17:24:45.175Z","normalizedAt":"2026-11-03T17:24:45.175Z"}]},"firstSeenAt":"2026-09-10T05:22:21.861Z","updatedAt":"2026-11-03T17:26:02.631Z"}