A small MCP server giving agents YouTube video context: transcripts, deep links, and metadata
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"youtube-context-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# youtube-context-mcp An [MCP](https://modelcontextprotocol.io) server that gives agents rich context about any YouTube video — what's said, what's popular, and what's on screen: - **Transcript** — plain or `[mm:ss]`-timestamped text, with optional translation - **Deep links** — `watch?v=…&t=…` URLs that jump straight to a moment - **Metadata** — title, channel, upload date, duration, view/like counts, chapters, tags - **Most-replayed moments** — the peaks of YouTube's viewer-interest heatmap - **Visuals** (for multimodal models) — a still frame at any moment, or a tiled preview sheet of the whole video Agents use it to answer questions about a video, summarize it, pull quotes, surface highlights, read what's on screen, or link you to exactly where something is said. It builds on [`youtube-transcript-api`](https://github.com/jdepoix/youtube-transcript-api) (transcripts) and [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) (metadata), which do the actual fetching, and shapes them into a focused set of MCP tools designed for agents. > Transcripts are a video's **existing captions/subtitles** — it does **not** transcribe audio > (no Whisper/ASR). Videos without captions have no transcript to return. ## Install Run it on demand with [uv](https://docs.astral.sh/uv/) (no install needed): ```bash uvx youtube-context-mcp@latest ``` Or install it: ```bash pip install youtube-context-mcp ``` ## Use it with an agent Add it to your MCP client config: ```json { "mcpServers": { "youtube-context": { "command": "uvx", "args": ["youtube-context-mcp@latest"] } } } ``` Or, in Claude Code: ```bash claude mcp add youtube-context -- uvx youtube-context-mcp@latest ``` ### Running over HTTP By default the server talks **stdio** (the client launches it). If your client runs on a different host — for example LM Studio on Windows while this server runs in WSL2 — run it as a long-lived HTTP server instead and point the client at a URL: ```bash youtube-c…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.