music-assistant

When to Use

Use these tools when the user wants to play music, control playback, or check what's playing.

Level 1 — Quick Reference

• music_play — Play an artist, album, track, playlist or genre on a speaker
• music_control — Pause, resume, skip, volume, shuffle, repeat
• music_search — Find artists, albums, tracks, playlists and genres by name; empty query = what's in the library
• music_now_playing — What's currently playing
• music_players — List available speakers

Search matches NAMES, not moods. "soft acoustic morning music" finds nothing. To play by mood, pick a genre and pass it as media: music_play(media="Folk") plays an endless shuffled mix of it. music_search(query="") lists the library's genres (with track counts) and a random handful of artists.

Never invent a speaker name. Omit player to use the default; call music_players first if the user named a specific one.

Parameter names matter. music_play takes media (not uri/query); music_control takes action (not command). A uri from music_search goes in media: music_play(media="library://track/123").

Level 2 — Usage Patterns