{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_j4pwrjn4dpnj","handle":"music-assistant-mcp","url":"https://wellknown.network/agents/music-assistant-mcp","links":{"self":"https://wellknown.network/agents/music-assistant-mcp/record.json","html":"https://wellknown.network/agents/music-assistant-mcp","markdown":"https://wellknown.network/agents/music-assistant-mcp/record.md","api":"https://wellknown.network/api/v1/agents/music-assistant-mcp","status":"https://wellknown.network/api/v1/agents/music-assistant-mcp/status","claim":"https://wellknown.network/agents/music-assistant-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/music-assistant-mcp/claim.json","badge":"https://wellknown.network/agents/music-assistant-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/music-assistant-mcp/history","tools":"https://wellknown.network/api/v1/agents/music-assistant-mcp/tools"},"ard":{"identifier":"urn:air::server:music-assistant-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"music-assistant-mcp","summary":"MCP server for Music Assistant – control playback, browse libraries, and manage queues via AI assistants","description":"# music-assistant-mcp\n\nAn [MCP](https://modelcontextprotocol.io/) server that wraps the [Music Assistant](https://music-assistant.io/) client library, exposing music search, library browsing, playback control, queue management, and playlist curation to AI assistants.\n\n## Configuring and Installing\n\n### Generate a Long-Lived Access Token First\n\n1. Navigate to your Music Assistant instance at `http://<your-ma-host>:8095/#/settings/profile`.\n2. Scroll down to the **Long-lived access token** section and click **+ Create new token**.\n3. Assign a name and submit.\n4. Copy the generated token value to a safe place — you will need it in the setup steps below.\n\n### Get Environment Variables Ready\n\nTo reach a Music Assistant instance, you'll need to set some environment variables: \n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MA_SERVER_URL` | Yes (or `MA_HOST`) | Full URL like `http://10.10.10.10:8095` |\n| `MA_HOST` | No | Hostname, combined with `MA_PORT` |\n| `MA_PORT` | No | Defaults to `8095` |\n| `MA_TOKEN` | Yes | Bearer token generated by Music Assistant |\n\nYou don't necessarily have to set these in your shell in a persistent way. These variables can typically be injected into the MCP server's execution context as necessary as shown in the examples below.\n\n### Claude Integration\n\nMany will want to use this MCP server from Claude Desktop, Claude Code, or another MCP host. You can add the MCP server to Claude Code with the CLI like this:\n\n```bash\nclaude mcp add --transport stdio music-assistant \\\n  --env MA_SERVER_URL=http://your-ma-host:8095 \\\n  --env MA_TOKEN=your-token \\\n  -- uvx music-assistant-mcp\n```\n\nOr add it to your Claude Code or Claude Desktop MCP configuration files as follows:\n\n```json\n{\n  \"mcpServers\": {\n    \"music-assistant\": {\n      \"command\": \"uvx\",\n      \"args\": [\"music-assistant-mcp@latest\"],\n      \"env\": {\n        \"MA_SERVER_URL\": \"http://your-ma-host:8095\",\n        \"MA_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n## …","publisher":null,"homepage":"https://github.com/devjourney/music-assistant-mcp","repository":"https://github.com/devjourney/music-assistant-mcp/issues","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["ai","audio","claude","fastmcp","home-assistant","mcp","model-context-protocol","music-assistant","smart-home"],"pricing":null,"endpoints":[{"url":"pypi:music-assistant-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.music","name":"Music & Audio","confidence":1,"provenance":"derived"},{"slug":"infra.devices","name":"Devices & IoT","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev","infra","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":"music-assistant-mcp","registry":"pypi","observedAt":"2026-10-28T17:24:08.420Z","publishedAt":"2026-03-23T02:18:43.469352Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"music-assistant-mcp","url":"https://pypi.org/project/music-assistant-mcp/","firstSeenAt":"2026-09-10T07:20:42.900Z","fetchedAt":"2026-10-28T17:22:56.657Z","normalizedAt":"2026-10-28T17:22:56.657Z"}]},"firstSeenAt":"2026-09-10T07:20:42.900Z","updatedAt":"2026-10-28T17:24:08.420Z"}