// MCP TOOL REFERENCE

SONOS TS TOOLS

60 tools from the Sonos Ts MCP Server, categorised by risk level.

// ALL 60 SONOS TS TOOLS

READ 26 tools

Read sonos_browse_albums Browse albums in the music library. Supports pagination for large collections. Read sonos_browse_artists Browse artists in the music library. Supports pagination for large collections. Read sonos_browse_genres Browse music genres in the library. Supports pagination for large collections. Read sonos_browse_item Browse a specific library item to get its children. For example, get albums for an artist or tracks for an ... Read sonos_browse_music_service Browse content from a music service. WARNING: Most services (especially Sonos Radio, Spotify, Apple Music) ... Read sonos_browse_playlists Browse Sonos playlists. Supports pagination for large collections. Read sonos_browse_tracks Browse all tracks in the music library. Supports pagination for large collections. Read sonos_discover Actively scan the network for Sonos devices using SSDP. Always call this when the sonos_list_devices tool r... Read sonos_get_eq Get current EQ settings including bass, treble, and loudness. Read sonos_get_favorite_radio_stations Get favorite radio stations from Sonos favorites. Returns a list of saved radio stations with their metadat... Read sonos_get_music_service_item_uri Get the playable streaming URI for a specific music service item. This is useful for debugging or inspectin... Read sonos_get_playback_state Get current playback settings including shuffle, repeat, crossfade, transport state, and speed. Read sonos_get_position_info Get current track information, position, and duration. Includes track metadata like title, artist, album. Read sonos_get_queue Retrieve the current playback queue with track information. Supports pagination for large queues. Read sonos_get_sleep_timer Get remaining sleep timer duration. Returns empty if no timer is active. Read sonos_get_transport_info Get current transport state (playing, paused, stopped) and playback speed. Read sonos_get_volume Get current volume level from a Sonos device. Read sonos_get_zone_groups Get zone group topology showing which devices are grouped together and their coordinator. Read sonos_list_alarms List all configured alarms including their schedule, enabled status, and room assignments. Read sonos_list_devices List devices currently in the registry. Note: Call sonos_discover first to populate the registry if a devic... Read sonos_list_music_services List all available music services (Sonos Radio, TuneIn, Spotify, etc.) registered with the Sonos system. Re... Read sonos_list_subscriptions List all active event subscriptions for a device including subscription IDs and services. Read sonos_search_library Search the music library by artist, album, track, or genre. Returns matching items. Read sonos_search_music_service Search for content within a music service. WARNING: Requires authentication for most services. Will return ... Read sonos_snapshot Take a snapshot of current device state including playback, volume, and EQ settings. Returns snapshot data ... Read sonos_subscribe_events Subscribe to real-time events from a Sonos device service to receive automatic notifications of state changes.

WRITE 23 tools

Write sonos_cancel_sleep_timer Cancel the active sleep timer. Write sonos_unjoin Remove a device from its current group, making it a standalone player. Write sonos_join_group Join a device to another device\ Write sonos_unsubscribe_all Unsubscribe from all active event subscriptions for a specific device. Write sonos_unsubscribe_events Unsubscribe from a specific event subscription to stop receiving notifications. Write sonos_add_device Manually add a Sonos device by IP address. Use when SSDP discovery fails due to network restrictions or fir... Write sonos_add_to_queue Add a track URI to the playback queue. Supports music library URIs and streaming service URIs. Optional met... Write sonos_create_alarm Create a new alarm with specified time, days, music source, and settings. Returns the alarm ID. Write sonos_party_mode Join all discovered devices to the specified device to create a whole-house audio experience. Write sonos_restore_snapshot Restore a previously saved snapshot to return device to its captured state. Optionally fade in volume. Write sonos_save_queue Save the current queue as a Sonos playlist with the specified title. Write sonos_set_bass Set bass EQ level. Range: -10 (reduced bass) to +10 (enhanced bass). Write sonos_set_crossfade Enable or disable crossfade between tracks. Crossfade creates smooth transitions between songs. Write sonos_set_dialog_mode Set dialog enhancement for home theater devices. Enhances speech clarity in movies and TV shows. Write sonos_set_loudness Enable or disable loudness compensation. Loudness boosts bass and treble at low volumes for better sound qu... Write sonos_set_mute Mute or unmute a Sonos device. Mute preserves volume level for quick unmute. Write sonos_set_night_mode Set night mode for home theater devices. Reduces loud sounds and enhances quiet sounds for late-night viewing. Write sonos_set_repeat Set repeat mode for queue playback. Options: off (no repeat), all (repeat entire queue), one (repeat curren... Write sonos_set_shuffle Enable or disable shuffle mode for queue playback. Write sonos_set_sleep_timer Set a sleep timer to automatically stop playback after the specified duration. Format: HH:MM:SS (e.g., Write sonos_set_treble Set treble EQ level. Range: -10 (reduced treble) to +10 (enhanced treble). Write sonos_set_volume Set volume level on a Sonos device. Range: 0 (silent) to 100 (maximum). Affects entire group if device is g... Write sonos_update_alarm Update an existing alarm. Only specified fields will be changed.

DESTRUCTIVE 3 tools

Destructive sonos_clear_queue Remove all tracks from the queue. Does not stop current playback. Destructive sonos_delete_alarm Delete an existing alarm permanently. Destructive sonos_remove_from_queue Remove a track from the queue at the specified position.

EXECUTE 8 tools

Execute sonos_play Start or resume playback on a Sonos device. Continues from current queue position and respects volume setti... Execute sonos_play_from_queue Start playing from the queue at a specific position. Execute sonos_previous Skip to previous track or restart current track if played more than a few seconds. Execute sonos_stop Stop playback on a Sonos device. Clears playback state, unlike pause which maintains position. Execute sonos_agent An AI-powered assistant that can take natural language instructions and autonomously control the Sonos syst... Execute sonos_next Skip to next track in the queue. Execute sonos_pause Pause playback on a Sonos device. Maintains current position in track and queue for quick resume. If device... Execute sonos_play_music_service_item Play a specific item from a music service such as a radio station, track, album, or playlist. Use the item ...

// FAQ

How many tools does the Sonos Ts MCP server have? +

The Sonos Ts MCP server exposes 60 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Sonos Ts tools? +

Route the Sonos Ts server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Sonos Ts tools fall into? +

Sonos Ts tools are categorised as Read (26), Write (23), Destructive (3), Execute (8). Each category has a recommended default policy.

Enforce policy on every Sonos Ts tool call.

Start from Sonos Ts, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.