MCP Overview
MZAP includes a built-in Model Context Protocol (MCP) server that enables AI assistants to control audio playback, routing, and system configuration via natural language.
What is MCP?
Section titled “What is MCP?”MCP is an open protocol that allows AI models to interact with external tools and data sources. MZAP implements an MCP server with a Streamable HTTP transport, accessible at the /mcp endpoint.
Capabilities
Section titled “Capabilities”The MCP server exposes 11 tool groups:
| Tool Group | Description |
|---|---|
| Playback | Play, pause, stop, seek, load tracks |
| Volume | Adjust player and zone volumes |
| Routing | Attach/detach players to zones |
| System | Initialize devices, health check |
| Player Management | Create/remove players |
| Playlists | List, create, modify playlists |
| DSP | Adjust EQ and compressor settings |
| Workspaces | Save, load, list workspaces |
| Jingles | Play jingles with ducking |
| Library | Search media library |
| Radio | Load internet radio streams |
Licensing
Section titled “Licensing”MCP access is gated by a license feature flag (Bit 0). It can be bypassed for development using the --enable-mcp CLI flag.
Connection
Section titled “Connection”Connect any MCP-compatible AI client to:
http://localhost:5000/mcpThe server uses Streamable HTTP transport and supports session tracking for concurrent connections.