Subwave

SUB/WAVE liveness

Check that the SUB/WAVE controller is reachable and the station reports on-air. Call this first when other tools fail — it separates 'stack is down' from 'endpoint-specific problem'.

Now playing on SUB/WAVE

Get the track currently on-air on the SUB/WAVE radio station, plus station context (time, weather, dominant mood) and live listener counts. Call this before requesting a song or sending a DJ update so the request fits what's actually playing (e.g. "something slower than this").

SUB/WAVE queue & history

Get the SUB/WAVE station state: the upcoming track queue, recently played history, and the DJ booth log. Use this to check whether a requested song already landed in the queue, or to review what the DJ has been doing.

SUB/WAVE schedule

Get the station's programming: DJ personas, shows, and the weekly schedule grid (interpreted in the station's timezone, which is included). Useful for knowing who's on air and whether a guest show or programme is running before firing 'banter' or 'programme-*' segments.

SUB/WAVE DJ session

Get the DJ's current stream session — its identity (show or auto period/mood, start time) and the recent transcript of spoken segments and events. This is what the DJ 'remembers'; read it to keep an announcement coherent with what was just said on-air.

Request a song

Submit a natural-language song request to the SUB/WAVE AI DJ. Accepts a specific track or artist ("play Midnight City by M83"), a vibe ("something calm for a rainy evening"), or a follow-on like "more like this". The DJ matches it against the library, writes a spoken intro, and queues the track — it does NOT interrupt the current song. The controller resolves requests in the background; this tool waits (up to ~15s) for the outcome and reports it (if still pending after that, poll subwave_request

Check a song request

Look up the outcome of a previously submitted song request by its requestId (returned by subwave_request_song). Status 'unknown' means the id was pruned or lost to a controller restart — stop polling.

Search the music library

Search the station's music library by title/artist/album terms. Returns up to 12 queue-ready tracks (id, title, artist, album, year, genre, duration, mood tags). ADMIN endpoint — no LLM, no rate limit. Pair with subwave_queue_track to queue an exact result.

Tracks that sound like this one

Find tracks whose ACTUAL SOUND (timbre, instrumentation, production, energy) is closest to a seed track — blind to tags and metadata, so it works for instrumentals and non-English tracks. Pass a track id (best; take it from subwave_now_playing or subwave_search_library) OR free text to resolve as a title/artist. Needs no admin credentials: it is gated by the STATION password and open on a public station. Never errors on a library without audio fingerprints — it returns an empty list plus a `reas

Queue an exact track

Push a specific track onto the play queue — an operator pick, no DJ intro, no rate limit. ADMIN endpoint. Pass the fields of a subwave_search_library result; id and title are required. The track plays after the queue ahead of it; it does not interrupt the current song.

Queue an album or artist block

Queue a whole album, or a run of tracks by one artist, in ONE action — the operator gesture behind an album show. ADMIN endpoint. Name the block with a trackId from any subwave_search_library result (the server resolves the album/artist off it), a pre-resolved album/artist id, or an artist name. An album is queued in its own disc/track order and can be neither shuffled nor limited — that ordering is the whole point of a block. Capped at 30 tracks; a longer record is truncated and says so. The ne

Skip the current track

Force-end the track playing right now and move to the next item — an operator override, since every listener hears the same broadcast. ADMIN endpoint. Use sparingly and deliberately; there is intentionally no listener-facing skip.

Send a DJ announcement

Make the SUB/WAVE DJ speak an update on-air — a news flash, a weather warning, a shout-out, anything you want voiced. ADMIN endpoint: needs admin credentials on this MCP connection. mode='styled' (default) treats your text as an instruction and lets the DJ rewrite it in persona before speaking — best when you give a topic or rough wording. mode='raw' speaks your text verbatim — best for exact wording (use raw for emergency alerts so nothing gets paraphrased). placement='solo' (default) is a heav

Fire a DJ voice segment

Trigger one of the SUB/WAVE DJ's scripted voice segments on demand: 'station-id' (station ident), 'hourly' (time/weather check-in), 'link' (a between-track auto-DJ link), 'banter' (multi-voice guest exchange — needs a guest show on air), or 'programme-intro'/'programme-feature'/'programme-outro' (episode beats — need a programme show on air; check subwave_schedule first). ADMIN endpoint. This is an operator override: it bypasses the DJ's frequency gate. For a custom message, use subwave_dj_annou

List DJ skills

List the DJ's between-track segment skills — the built-ins (weather, news, traffic, curiosity, album-anniversary, library-deep-cut, web-search) plus any operator-authored skills — with their labels, cooldowns, and enabled state. ADMIN endpoint. Use the 'name' field with subwave_run_skill.

Run a DJ skill

Run one of the DJ's segment skills on-air right now — e.g. 'weather' for a weather check-in, 'news' for a headlines beat, or any custom skill the operator has installed. The segment director fetches real data and voices it in persona. ADMIN endpoint; operator override (ignores cooldowns and the frequency gate, works even on a disabled skill). List valid names with subwave_list_skills.

List sound effects

List the station's sound-effects library — short stingers (≤10s) the DJ can play under a voice line or on their own. ADMIN endpoint. Use a returned name with subwave_play_sfx or the sfx parameter of subwave_dj_announce.

Play a sound effect on-air

Fire a sound effect from the station library on-air immediately — mixed over the programme with a light music duck (it does not stop the song). ADMIN endpoint. Good as a standalone attention cue; to pair a stinger with spoken words, prefer subwave_dj_announce's sfx parameter so the two are aligned. List valid names with subwave_list_sfx.

List jingles

List the station's jingle library — full-level clips (idents, event announcements) that play as their own item in the programme rather than under it. Unlike sound effects these have no length cap. ADMIN endpoint. Use a returned filename with subwave_play_jingle.

Air a jingle

Queue a jingle from the station library to air at the next safe track boundary — at full level, with the programme yielding to it. ADMIN endpoint. This is the tool for anything longer than a stinger (an event announcement, a sponsor spot, a station ident): subwave_play_sfx mixes UNDER the music and is capped at 10 seconds. It is queued, not instant — the station never cuts a song off mid-play, and active speech or a bed/track pair defers it. DO NOT retry a call that succeeded: the queue behind t

Refresh the auto-playlist

Rebuild the Liquidsoap fallback auto-playlist for the current mood right now, instead of waiting for the scheduled refresh. ADMIN endpoint. Use after big library changes or a mood shift; it does not affect the current track or the request queue.