{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qygqma8ukq5h","handle":"yt-music-mcp","url":"https://wellknown.network/agents/yt-music-mcp","links":{"self":"https://wellknown.network/agents/yt-music-mcp/record.json","html":"https://wellknown.network/agents/yt-music-mcp","markdown":"https://wellknown.network/agents/yt-music-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yt-music-mcp","status":"https://wellknown.network/api/v1/agents/yt-music-mcp/status","claim":"https://wellknown.network/agents/yt-music-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yt-music-mcp/claim.json","badge":"https://wellknown.network/agents/yt-music-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yt-music-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yt-music-mcp","summary":"MCP server for YouTube Music — lets AI agents search, browse, and manage your library via ytmusicapi.","description":"# yt-music-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that exposes [YouTube Music](https://music.youtube.com) to AI agents, via [`ytmusicapi`](https://github.com/sigma67/ytmusicapi).\n\nAgents can search the catalog, browse artists/albums/songs, read the user's library and history, and create/edit/delete playlists, rate songs, and manage subscriptions.\n\n---\n\n## Quickstart\n\nYou need two things in your config:\n\n1. **A way to run the server** — recommended: `uvx yt-music-mcp` (no install needed, [`uv`](https://docs.astral.sh/uv/) fetches it on first use).\n2. **Your YouTube Music auth** — a one-time capture of request headers from `music.youtube.com`, stored either inline in the config or in a `browser.json` file.\n\n### 1. Capture auth (one time, ~2-year validity)\n\nSkip this if you only need public search/browsing.\n\n1. Open <https://music.youtube.com> in a desktop browser, logged in.\n2. Open DevTools (F12) → **Network** tab.\n3. Click around to trigger traffic, then find any request to `/youtubei/v1/...`.\n4. Right-click that request → **Copy** → **Copy request headers**.\n\nThen run **one** of:\n\n```bash\n# Option A — print the JSON to stdout so you can paste it into your config.\nuvx yt-music-mcp setup-auth --stdout\n\n# Option B — write a browser.json file you'll reference by path.\nuvx yt-music-mcp setup-auth --out ~/.yt-music-mcp/browser.json\n```\n\nPaste your headers when prompted, then Ctrl-D (Ctrl-Z + Enter on Windows).\n\n### 2. Configure your MCP client\n\nPick your client and paste one of the snippets below. Use the **inline JSON** variant if you used `--stdout`, or the **file path** variant if you used `--out`.\n\n#### Claude Desktop\n\nConfig file:\n\n| OS | Path |\n|---|---|\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n**Inline JSON (recommended):**\n\n```json\n{\n  \"mcpServers\": {\n    \"yt-music\": {\n      \"command\": \"uvx\",\n …","publisher":{"name":"Thanaen","url":null},"homepage":"https://github.com/Thanaen/yt-music-mcp","repository":"https://github.com/Thanaen/yt-music-mcp","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["ai-agents","claude","mcp","youtube-music","ytmusicapi"],"pricing":null,"endpoints":[{"url":"pypi:yt-music-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"media.music","name":"Music & Audio","confidence":1,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["dev","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":"yt-music-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:30.357Z","publishedAt":"2026-04-16T22:08:28.518237Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yt-music-mcp","url":"https://pypi.org/project/yt-music-mcp/","firstSeenAt":"2026-09-10T16:23:35.064Z","fetchedAt":"2026-09-10T16:23:35.064Z","normalizedAt":"2026-09-10T16:23:35.064Z"}]},"firstSeenAt":"2026-09-10T16:23:35.064Z","updatedAt":"2026-09-10T16:24:30.357Z"}