{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_a3eaembvhgcp","handle":"mcp-pyatv","url":"https://wellknown.network/agents/mcp-pyatv","links":{"self":"https://wellknown.network/agents/mcp-pyatv/record.json","html":"https://wellknown.network/agents/mcp-pyatv","markdown":"https://wellknown.network/agents/mcp-pyatv/record.md","api":"https://wellknown.network/api/v1/agents/mcp-pyatv","status":"https://wellknown.network/api/v1/agents/mcp-pyatv/status","claim":"https://wellknown.network/agents/mcp-pyatv/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-pyatv/claim.json","badge":"https://wellknown.network/agents/mcp-pyatv/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-pyatv/history","tools":"https://wellknown.network/api/v1/agents/mcp-pyatv/tools"},"ard":{"identifier":"urn:air::server:mcp-pyatv","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-pyatv","summary":"MCP server for controlling Apple TV, HomePod, and AirPlay devices via pyatv","description":"# mcp-pyatv\n\nMCP server for controlling Apple TV, HomePod, and AirPlay devices via [pyatv](https://github.com/postlund/pyatv).\n\n![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)\n![Python 3.11-3.13](https://img.shields.io/badge/Python-3.11--3.13-green.svg)\n\n---\n\n## What It Does\n\nmcp-pyatv is an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that bridges any MCP client to Apple TV, HomePod, and AirPlay devices on your local network. It wraps [pyatv](https://github.com/postlund/pyatv) -- the open-source Python library that implements the actual Apple TV and AirPlay protocols -- and exposes its functionality as MCP tools.\n\nThis lets you control your devices using natural language through Claude Desktop, Claude Code, Cursor, or any other MCP-compatible client.\n\n**This project does not implement any device protocols.** All protocol-level communication is handled by pyatv. mcp-pyatv is purely the MCP bridge layer.\n\n## Supported Devices\n\n- **Apple TV** -- all generations, including tvOS 15+\n- **HomePod / HomePod Mini**\n- **AirPort Express**\n- **Third-party AirPlay speakers**\n- **macOS** (Music/iTunes)\n\n## Quick Start\n\n### Install\n\n```bash\npip install mcp-pyatv\n```\n\nOr run directly without installing:\n\n```bash\nuvx mcp-pyatv\n```\n\n### Claude Desktop Configuration\n\nAdd this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-tv\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--python\", \"python3.13\", \"mcp-pyatv\"]\n    }\n  }\n}\n```\n\n> **Note:** Claude Desktop may not inherit your shell's PATH. If you get a \"command not found\" error, use the full path to `uvx` (run `which uvx` in your terminal to find it):\n>\n> ```json\n> {\n>   \"mcpServers\": {\n>     \"apple-tv\": {\n>       \"command\": \"/Users/you/.local/bin/uvx\",\n>       \"args\": [\"--python\", \"python3.13\", \"mcp-pyatv\"]\n>     }\n>   }\n> }\n> ```\n\n### Local Development\n\nIf you've cloned the repo and want to ru…","publisher":{"name":"crlian","url":null},"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["airplay","apple-tv","homepod","mcp","model-context-protocol","pyatv"],"pricing":null,"endpoints":[{"url":"pypi:mcp-pyatv","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"}],"categories":["dev"],"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":"mcp-pyatv","registry":"pypi","observedAt":"2026-10-28T12:23:05.318Z","publishedAt":"2026-03-30T04:38:06.492200Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-pyatv","url":"https://pypi.org/project/mcp-pyatv/","firstSeenAt":"2026-09-10T03:18:55.048Z","fetchedAt":"2026-10-28T12:22:15.410Z","normalizedAt":"2026-10-28T12:22:15.410Z"}]},"firstSeenAt":"2026-09-10T03:18:55.048Z","updatedAt":"2026-10-28T12:23:05.318Z"}