Play an item now in a Roon zone
play_nowInstantly plays a selected album, artist, playlist, or track in your preferred Roon zone, replacing the current queue. Provide a search result key and optionally target a specific zone.
Instructions
Use this when the user wants one specific thing playing right now — an album, artist, playlist, genre mix, or single track (e.g. "play Tycho", "put on In Rainbows", "start some Psytrance in the office", "play that track"). Immediately plays a single search candidate in the target zone and replaces whatever was queued. Pass an itemKey from a recent search_music (or get_tracks_for) result — item keys are session-scoped, so use a fresh one. zoneId is optional: omit it to use ROON_DEFAULT_ZONE, or fall back to the only zone / an "Office" zone / the currently-playing zone; if it still can't decide it returns ZONE_AMBIGUOUS so the agent can ask the user or call list_zones. Optionally shuffle. Returns a PlaybackResult.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"itemKey": "<itemKey>"
},
"name": "play_now"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zoneId | No | Target zone id or output id from list_zones (e.g. an id, or a name substring like 'Office'). Omit to use ROON_DEFAULT_ZONE or fall back automatically. | |
| itemKey | Yes | What to play — item key from a recent search_music or get_tracks_for result (album, artist, playlist, genre, track, etc.). | |
| shuffle | No | Shuffle the selection when starting playback. |