Search Roon music
search_musicSearch for artists, albums, tracks, playlists, radio stations, or genres in your Roon library. Returns candidates ready for playback via get_tracks_for.
Instructions
Use this when the user names music to find — an artist, album, track, playlist, radio station, or genre (e.g. "find Tycho", "look up the album In Rainbows", "play some Psytrance", "anything by Ryuichi Sakamoto?"). Resolves a free-text query into ranked Roon browse candidates. Optionally restrict to one item type (artist, album, track, genre, playlist, radio); for non-genre types, an empty typed search broadens to all categories. type:"genre" is special — genres don't appear in Roon's flat search, so the server walks the dedicated Genres tree and returns the nearest-match genre nodes (with parent path in the subtitle) without broadening; e.g. "Psychedelic Trance" yields "Psytrance"/"Trance". Set includeStreaming:true (only meaningful for type:"genre") to also pull a track mix from streaming services (e.g. TIDAL): the server takes the genre-relevant albums and samples tracks across them, so library genre nodes come first and ready-to-play streaming tracks are appended after. Returns opaque, session-scoped item keys for use by the playback tools — pair with get_tracks_for to expand, then play_now or enqueue_and_play.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to search for — an artist, album, track, playlist, radio, or genre name (e.g. 'Tycho', 'In Rainbows', 'Dark Ambient'). | |
| type | No | Restrict the search to one item type. Omit to broaden across all non-genre categories. Use 'genre' for music-genre lookups. | |
| limit | No | Max candidates to return (default 10). | |
| includeStreaming | No | Only for type 'genre': also pull a track mix from streaming services (e.g. TIDAL). Library genre nodes come first, then sampled streaming tracks. Default false (library only). |