YouTube Transcript MCP Server — Cloud-Safe Markdown Captions at $0.001
Local youtube-transcript CLI scripts and datacenter IPs routinely break on bot-check gates. AgentAPIGate delivers multi-tier resilient YouTube caption extraction in clean LLM-ready Markdown (-86% context tokens) with 30-day edge caching.
claude mcp add --transport http agentapigate-youtube-transcript "https://mcp.agentapigate.ai/mcp/custom?tools=youtube.video.transcript,youtube.video.detail,youtube.search.videos,youtube.channel.videos" \ --header "Authorization: Bearer aag_live_YOUR_KEY"
# 1. Inspect deterministic 402 quote (Base USDC + Solana USDC + Tempo MPP): curl -i "https://api.agentapigate.ai/v1/youtube/video/transcript?video_id=aircAruvnKk&lang=en&format=compact" # 2. Or execute immediately with an aag_live_* / scoped aag_agent_* key: curl -s "https://api.agentapigate.ai/v1/youtube/video/transcript?video_id=aircAruvnKk&lang=en&format=compact" \ -H "Authorization: Bearer $AAG_API_KEY" \ -H "X-AAG-Max-Cost: 0.0100"
{
"ok": true,
"meta": {
"endpoint": "youtube.video.transcript",
"format": "compact",
"cost_usd": 0.001,
"tokens_est": 193,
"raw_tokens_est": 27768,
"tokens_saved_pct": 99,
"latency_ms": 4749,
"content_trust": "external_untrusted"
},
"data": {
"video_id": "aircAruvnKk",
"title": "But what is a neural network? | Deep learning chapter 1",
"language": "en",
"segment_count": 286,
"transcript_text": "This is a 3. It's sloppily written and rendered at an extremely low resolution of 28x28 pixels, but your brain has no trouble recognizing it as a 3. And I want you to take a moment to appreciate how crazy it is that brains can do this so effortlessly. I mean, this, this and this are also recognizable as 3s, even though the specific values of each pixel is very different from one image to the next. The particular light-sensitive cells in your eye that are firing when you see this 3 are very different from the ones firing when you see this 3. But something in that crazy-smart visual cortex of yo…"
}
}Why Engineers Mount This Connector via AgentAPIGate
- 01 · GUARANTEE
Multi-tier transcript resolution bypasses datacenter IP "Sign in to confirm you’re not a bot" blocks that break local Python/Node MCP scripts.
- 02 · GUARANTEE
Returns both clean concatenated Markdown prose (?format=md) and timestamped segment arrays ({ start_sec, duration_sec, text }) for exact citation.
- 03 · GUARANTEE
$0.0010 per transcript ($1 = 1,000 videos), with 30-day deterministic caching and $0.00 charged if a video genuinely has no captions.
Included MCP Tools & Deterministic Per-Call Pricing
Browse all 74 endpoints →| MCP Tool / Endpoint ID | Summary | API Key Price | x402 / MPP | p50 Latency | Bonus Credit |
|---|---|---|---|---|---|
| youtube_video_transcript youtube.video.transcript | Extract full clean text transcript and timestamped caption segments from any captioned YouTube video (#1 LLM RAG workflow). | $0.0010 | $0.0010 | 4749 ms | Eligible |
| youtube_video_detail youtube.video.detail | Retrieve YouTube video title, channel info, view count, duration, keywords, and description by video ID or URL. | $0.0010 | $0.0010 | 349 ms | Eligible |
| youtube_search_videos youtube.search.videos | Search YouTube videos with video IDs, titles, channel names, view counts, and publish times. | $0.0010 | $0.0010 | 496 ms | Eligible |
| youtube_channel_videos youtube.channel.videos | Fetch latest uploaded videos for a YouTube channel ID (`UC...`). | $0.0010 | $0.0010 | 11 ms | Eligible |
Frequently Asked Questions
Why do local YouTube transcript MCP servers fail on AWS, Hetzner, or CI runners?
Direct unauthenticated caption scraping from cloud ASN ranges triggers anti-bot challenges or empty caption tracks. AgentAPIGate routes through enterprise-backed multi-tier caption resolvers and only bills on non-empty transcripts.
Can I pass either a full YouTube URL or an 11-character video_id?
Pass the 11-character video_id (for example aircAruvnKk), or pair youtube.search.videos with youtube.video.transcript so your agent discovers and summarizes videos autonomously.