
yt-dlp MCP
Download video and audio with yt-dlp via AI agents: inspect, batch, subtitles, convert.
- GitHub stars
- 1
- tools
- 13
- transport
- STDIO
- env vars
- 4
- last updated
- Nov 17, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
probeRead title, duration, uploader, views, thumbnail, and description
Read title, duration, uploader, views, thumbnail, and description
No parameter schema in public metadata yet.
formatsList available media formats, quality, and estimated sizes
List available media formats, quality, and estimated sizes
No parameter schema in public metadata yet.
supportedCheck whether a URL matches a locally installed yt-dlp extractor
Check whether a URL matches a locally installed yt-dlp extractor
No parameter schema in public metadata yet.
inspectRecommend a download action, quality, and available resolutions
Recommend a download action, quality, and available resolutions
No parameter schema in public metadata yet.
get_videoDownload video, default output is MP4
Download video, default output is MP4
No parameter schema in public metadata yet.
get_audioExtract audio as Opus, MP3, or M4A
Extract audio as Opus, MP3, or M4A
No parameter schema in public metadata yet.
get_subtitlesDownload manual or auto-generated subtitles as VTT
Download manual or auto-generated subtitles as VTT
No parameter schema in public metadata yet.
adviseAnswer yt-dlp configuration questions
Answer yt-dlp configuration questions
No parameter schema in public metadata yet.
queuePreview a batch of URLs and per-item download plans
Preview a batch of URLs and per-item download plans
No parameter schema in public metadata yet.
fetch_allDownload a batch of URLs with optional delays
Download a batch of URLs with optional delays
No parameter schema in public metadata yet.
watchList entries from a playlist or channel without downloading
List entries from a playlist or channel without downloading
No parameter schema in public metadata yet.
searchSearch YouTube or SoundCloud and return compact metadata
Search YouTube or SoundCloud and return compact metadata
No parameter schema in public metadata yet.
convertRe-encode a local video using FFmpeg presets
Re-encode a local video using FFmpeg presets
No parameter schema in public metadata yet.
Sponsors
Configuration
YTDLP_DOWNLOAD_DIRDirectory where downloaded files are saved.
YTDLP_COOKIES_FILEPath to a Netscape-format cookies.txt file for sites that require a signed-in session. Never paste cookie contents into chat.
YTDLP_BINdefault: yt-dlpPath to the yt-dlp binary.
FFMPEG_BINdefault: ffmpegPath to the ffmpeg binary, used for merging and converting.
Readme
An MCP server that lets AI agents inspect, download, and convert video and audio using yt-dlp and FFmpeg through natural language instructions.
Example
Send a link, get the file. Or type /ytdlp-mcp in OpenCode, Gemini CLI, or Claude Code:
chat
Install
git clone https://github.com/fanyzp/ytdlp-mcp.git && cd ytdlp-mcp && npm run setup
Requires yt-dlp, ffmpeg, Node 18. Or copy PROMPT.md into any AI agent and let it install for you.
Tools
Details
- Repository
- github.com/fanyzp/ytdlp-mcp
- Category
- Media & Entertainment
- Package
@fanyzp/ytdlp-mcp- Transport
- STDIO
- Registry
- MCP registry, active