{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_f9kjjrk5g3dv","handle":"youtube-watch-mcp","url":"https://wellknown.network/agents/youtube-watch-mcp","links":{"self":"https://wellknown.network/agents/youtube-watch-mcp/record.json","html":"https://wellknown.network/agents/youtube-watch-mcp","markdown":"https://wellknown.network/agents/youtube-watch-mcp/record.md","api":"https://wellknown.network/api/v1/agents/youtube-watch-mcp","status":"https://wellknown.network/api/v1/agents/youtube-watch-mcp/status","claim":"https://wellknown.network/agents/youtube-watch-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/youtube-watch-mcp/claim.json","badge":"https://wellknown.network/agents/youtube-watch-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/youtube-watch-mcp/history","tools":"https://wellknown.network/api/v1/agents/youtube-watch-mcp/tools"},"ard":{"identifier":"urn:air::server:youtube-watch-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"youtube-watch-mcp","summary":"Fast, minimal YouTube watch engine for AI agents — clean transcripts, no API key required.","description":"# Youtube MCP\n\n> Fast, minimal, and reliable YouTube MCP for AI agents.\n\n![Banner](./public/Youtube-MCP-banner.png)\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add youtube -- uvx youtube-watch-mcp\n```\n\n> **Before publish (local dev):** point `uvx` at the checkout instead:\n> `claude mcp add youtube -- uvx --from /path/to/youtube-mcp youtube-watch-mcp`\n\n### Claude Desktop / Codex / other MCP clients\n\nAdd to the client's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube\": {\n      \"command\": \"uvx\",\n      \"args\": [\"youtube-watch-mcp\"]\n    }\n  }\n}\n```\n\n### CLI only\n\n```bash\nuvx --from youtube-watch-mcp youtube-watch-mcp-cli info \"https://youtu.be/VIDEO_ID\"\n```\n\nThat's it. `uvx` pulls `youtube-watch-mcp`, `yt-dlp`, and dependencies into an isolated environment automatically. Nothing to install globally.\n\n> **Optional:** `ffmpeg` on PATH is required **only** for `--asr` (speech-to-text on caption-less videos). Core transcript extraction needs nothing.\n\n## Optional API key\n\nA YouTube Data API key is **not needed** to read videos. Add one only to enable cross-YouTube **search**:\n\n```bash\nclaude mcp add youtube -e YOUTUBE_API_KEY=your_key -- uvx youtube-watch-mcp\n```\n\nTranscript extraction never uses the key (YouTube only allows caption download for video owners).\n\n## Tools\n\n| Tool | Returns | Purpose |\n|------|---------|---------|\n| `get_info(url)` | title, duration, chapters, has_captions | Cheap probe before fetching. |\n| `get_transcript(url, asr=False)` | file path + word count + preview | Clean transcript to disk. Returns path, not full text. |\n| `search_transcript(url, query)` | timestamped snippets | Grep a long video without loading it all. |\n| `get_segment(url, start, end)` | text slice | Read one time range. |\n\nDesign principle: **pull, don't dump.** Transcripts write to a local cache file; tools return a path and a short preview. The agent reads or searches on demand — long videos never flood the context.\n\n```\n/get_info $url\n/get_transcript $url\n/search_tr…","publisher":null,"homepage":null,"repository":null,"version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:youtube-watch-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"media.speech-recognition","name":"Speech Recognition","confidence":0.814,"provenance":"derived"},{"slug":"media.video-editing","name":"Video Editing","confidence":0.802,"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":"youtube-watch-mcp","registry":"pypi","observedAt":"2026-10-29T02:26:49.554Z","publishedAt":"2026-07-06T02:21:08.529154Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"youtube-watch-mcp","url":"https://pypi.org/project/youtube-watch-mcp/","firstSeenAt":"2026-09-10T16:23:32.330Z","fetchedAt":"2026-10-29T02:26:11.097Z","normalizedAt":"2026-10-29T02:26:11.097Z"}]},"firstSeenAt":"2026-09-10T16:23:32.330Z","updatedAt":"2026-10-29T02:26:49.554Z"}