MCP Tools Reference

This page lists all MCP tools exposed by MZAP's built-in MCP server.

Which of these a client can see and call depends on its API key's role when authentication is enabled.

Word-valued parameters

Several tools take words rather than JSON booleans, because LLM clients frequently send boolean arguments as quoted strings, which failed with a JSON error before the tool ran:

Tool	Parameter	Accepts
set_player_volume, set_zone_volume	mute	"mute" / "unmute"
set_equalizer, set_compressor	enabled	"on" / "off"

Common variants (true/false, yes/no, 1/0, enable/disable) are also accepted, and an unrecognized value returns a readable error instead of failing to parse.

Scripted callers

Callers that passed a real JSON boolean to these parameters need updating.

Playback Tools

• play — Start playback on a player
• pause — Pause playback
• stop — Stop playback
• seek — Seek to a position in the current track
• load — Load a file or URL into a player

Volume Tools

• set_player_volume — Set a player's volume level. mute takes "mute" / "unmute".
• set_zone_volume — Set a zone's volume level. mute takes "mute" / "unmute".
• mute_zone — Mute or unmute a zone

Routing Tools

• attach_zones — Route a player to one or more zones
• detach_zones — Remove a player from zones
• get_matrix — Get the current routing matrix

System Tools

• init_devices — Initialize the audio engine
• get_devices — List available audio devices
• health_check — Check system status

Player Management Tools

• create_player — Create a new player
• create_airplay_player — Create an AirPlay input player. Accepts an optional endpoint password.
• remove_player — Remove an existing player
• list_players — List all players

Playlist Tools

• list_playlists — List all playlists
• create_playlist — Create a new playlist
• add_to_playlist — Add tracks to a playlist

DSP Tools

• set_equalizer — Apply EQ settings to a player or zone. enabled takes "on" / "off".
• set_compressor — Apply compressor settings. enabled takes "on" / "off".
• list_presets — List available DSP presets

Workspace Tools

• get_workspace_info — Workspace information and the list of available workspaces. Read-only, so it does not require Admin. The workspace resource also lists AirPlay session state per player.
• manage_workspace — save and load actions. Admin only.

Split in 7.2.0.115

manage_workspace previously also carried the info and list actions, which meant read-only use required Admin. Those two moved to the new get_workspace_info tool.

Jingle Tools

• play_jingle — Play a jingle with ducking
• create_tts_jingle — Synthesize and create a text-to-speech jingle in one call. Accepts name, text, and optional provider, voice_id, language, and rate. Returns the new jingle ID so a follow-up play_jingle can target it. Honors license/key gating (Cloud TTS) and the character limit.
• list_tts_voices — Enumerate the voices available for a TTS provider, so an AI client can pick a voice_id before calling create_tts_jingle. Accepts an optional provider (Windows, Azure, or ElevenLabs).

Library Tools

• search_library — Search the media library

Radio Tools

• load_radio — Load an internet radio stream into a player