OffStereo

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Builds narrated, playable music stories, explores sample lineage, and saves verified playlists.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "OffStereo": {
      "url": "https://www.offstereo.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• create_authored_story

  Use action=article with title, url and pasted text to draft a cited adaptation for review; this does not fetch the URL. Inspect its evidence and narration before action=review. Use action=intake with title and notes to organize a pasted document into an editable draft. Review all extracted identities and unassigned lines before action=review. Turn a supplied ordered set list and exact liner notes into a playable story without rewriting them. First use action=review with material, present the returned recordings, narration and issues for approval, then action=prepare with that reviewId after approval. To edit an owned story, action=revise takes sessionId and narration changes, returns a new review, and leaves the original unchanged. Reviews expire after 30 minutes. After preparation, export_video with sessionId and narration beatId creates a short narrated video; video_status with jobId reports progress and signed-in browser download links. Downloads require the same owner to sign in; these links are not public or bearer download URLs. Use credits with sessionId for the saved transcript, source credits, recording identities and owner-only return path. Does not publish or start playback. Music rights are not granted and narration export does not include music.

  Parameters:

  • action (required) — string
  • url — string
  • text — string
  • jobId — string
  • notes — string
  • title — string
  • beatId — string
  • changes — array
  • material — object
  • reviewId — string
  • sessionId — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• make_playable

  Create one playable OffStereo card for a direct standalone-song or narrated-story request. Discovery and Music Today already play their songs, so keep those results in their original card unless the listener asks for dedicated controls. experience=single_track returns exactly one recording with no narration or library save; pass artist plus track. experience=story progressively creates a sourced story; mode=fresh starts a new build. Pass artist plus album for an exact record and trackCount for an exact requested length. Spotify, Apple Music, and SoundCloud URLs are story seeds unless the listener requests only the recording. Playlist requests use create_playlist. existingSessionId opens a selected library story; get_session is reserved for card polling. The mounted card owns live progress and playback. Assistant prose should avoid restating transient stages such as building, recording, or still working because they become stale as the card updates, and should wait for Ready before stating final counts. A tool call opens the card without starting playback.

  Parameters:

  • mode — string — fresh starts an explicitly new story; auto may reuse an exact strong match.
  • album — string — Exact album or EP title, paired with artist when the listener names or shows a specific record.
  • title — string — Short canonical artist, track, album, or subject title for the card, especially useful for an identified image or a prompt that also contains workflow instructions.
  • track — string — Exact song title, paired with artist for reliable single_track matching.
  • artist — string — Exact artist, paired with track for a one-song card or with album for an album-focused story.
  • length — string — short fits an explicitly quick, brief, or concise narrated story and targets three narration-and-record chapters; standard keeps the full editorial arc.
  • prompt — string — What the listening experience should explain.
  • tracks — array — Optional: exact records the story should always include as playable tracks — e.g. every song a paired video names. They are pinned into the show in this order and curation fills the remaining slots up to trackCount, so a companion keeps the records the video discusses. Leave unset for normal curation.
  • sourceUrl — string — An http(s) article or source URL to adapt.
  • videoMode — boolean — When true, the story opens on a third-person editorial hook with no DJ greeting or time-of-day welcome — for a companion story paired with a video. Pair with an explicit `title` so page title, URL, and register all match the video.
  • experience — string — single_track means one immediate song card with no narration or story creation; story means the full progressive narrated experience.
  • sourceText — string — Source text or conversation context to adapt.
  • trackCount — number — Exact number of songs requested for a narrated story (2-12). Use 1 with experience=single_track.
  • resumeShowId — string — Rebuild an unfinished show in place, keeping its id and URL, instead of creating a second one. Pass the id of a show whose `retryable` is true. Rejected for a show that already finished or that belongs to someone else.
  • personalization — string — library uses connected-listener taste as retrieval seeds; none is the default.
  • existingSessionId — string — The chosen library story id for opening through the canonical player contract; get_session remains application polling.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_session read-only

  Application polling for an already-mounted OffStereo card. It refreshes one PlayableSession in place. A selected library story opens through make_playable(existingSessionId), while playback and contextual follow-ups use steer_session.

  Parameters:

  • sessionId (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• steer_session

  Control and contextual follow-ups for the active player: pause, resume, skip, play the next song, append one exact next song, adjust the music level, explain why a song is present, open an explicitly requested documented sample lineage, or return to the story. The result updates the mounted card in place. For an AI-DJ transition to a newly chosen record, pass queueTrack with exact artist and title; OffStereo resolves it and appends it to this same widget so the current song can finish and auto-advance. Keeping the transition in this queue avoids a second make_playable call. Use instruction='Queue this as the next song without interrupting the current song' to queue ahead, or 'Play this next now' to append and immediately advance. A why-this-song question preserves the queue. sessionId identifies the active session, and activeItemId plus positionMs preserve exact continuity when the card supplies them.

  Parameters:

  • instruction (required) — string
  • sessionId — string
  • positionMs — number
  • queueTrack — object — One exact new record to append to the active widget queue. Use this instead of opening another one-song widget when the listener asks the AI DJ to choose what comes next.
  • activeItemId — string
  • playbackState — string
  • acknowledgeDirectiveId — string — Mounted-card acknowledgement for the exact one-shot playback directive it has finished applying. Periodic cursor syncs omit this field.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• discover read-only

  Discover genre-aware new releases, strong public-archive matches, or popular OffStereo shows. Call exactly once per listener request: put every positive genre into the same genres array, use [] when none were requested, and avoid one call or card per genre. query carries the listener's full wording, exclusions, counts, and no-padding constraint. Results remain relevant rather than padding a requested genre or archive search with unrelated rows. Dated music-history requests use music_today and are not a discover mode. playableOnly limits results to music that plays in ChatGPT. allowBuild and allowSave preserve a read-only request. The result card already includes song playback; a separate one-song card is for an explicit request for a dedicated song card.

  Parameters:

  • type (required) — string — Discovery mode. trending returns the pre-built fresh surface: the Friday Rundown, this week's records and today's anniversary, chart and news stories, every one already built and playable; search aliases archive; dated music-history requests use music_today.
  • genres (required) — array — Every positively requested genre; [] when the request is not genre-filtered. Results do not pad with unrelated genres.
  • limit — number — Maximum total results (1-20).
  • query — string — Archive query, or the listener's release-discovery wording when it contains genres, balance, count, or no-padding constraints.
  • allowSave — boolean — False preserves an explicit request not to create or save anything.
  • allowBuild — boolean — False preserves an explicit request not to create or build a story.
  • playableOnly — boolean — True limits results to music with audio that plays inside ChatGPT.
  • perGenreLimit — number — Maximum results from each named genre for a balanced new-release request.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• music_today read-only

  Call exactly once for a 'today in music' or dated music-history request. One response already combines album anniversaries, artist birthdays and memorials, current releases, current US song-chart context, and related playable OffStereo stories; use that one combined call rather than separate history, releases, charts, or shows calls. dateMode=today uses the listener's current day and omits date; dateMode=explicit pairs with a named YYYY-MM-DD date. limit is the maximum total across the combined response, playableOnly limits rows to music that plays in ChatGPT, and allowBuild=false plus allowSave=false preserves a read-only request. This is the only dated-music tool in the current schema.

  Parameters:

  • dateMode (required) — string — today represents the listener's current day; explicit represents one named calendar date.
  • date — string — ISO date YYYY-MM-DD for dateMode=explicit; absent for dateMode=today.
  • limit — number — Maximum total results across the already-combined response (1-20, default 8). Honor an explicit result count.
  • allowSave — boolean — False preserves an explicit request not to create or save anything.
  • allowBuild — boolean — False preserves an explicit request not to create or build a story.
  • playableOnly — boolean — True limits music-history results to rows with audio playable in ChatGPT.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• explore_lineage

  Explore documented sample lineage. Pass artist + track for one song, or topic for one multi-song narrated lineage story. OffStereo only returns connections it can source and withholds uncertain matches rather than guessing.

  Parameters:

  • topic — string — Artist/topic request such as 'notable samples used by Nas'.
  • track — string — Track title for a track-level lineage.
  • artist — string — Artist for a track-level lineage.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_playlist

  Create one playlist from a natural-language idea or explicit track list. Call exactly once per listener turn: do not inspect the result and make a corrective second call or stack another playlist card in the same response. previewOnly=true returns one authoritative playlist that can be heard before saving and needs no music-service connection. After explicit approval, previewOnly=false with the approved tracks and the same concise editorial name creates one private playlist in the listener's active music service. Pass service only when the listener explicitly names Spotify or Apple Music. requiredArtists carries every artist the listener named as required. allowSecondPlaylist is true only for an explicit request for a separate additional playlist. Sign-in recovery preserves the exact request and pendingActionId for a safe retry.

  Parameters:

  • name — string — A concise editorial playlist title. Omit it when the listener did not supply a title; OffStereo derives one from the prompt.
  • count — number — Target song count for prompt-generated playlists (1-50, default 20).
  • prompt — string — A conceptual playlist request, e.g. 'connect A Tribe Called Quest to Steely Dan'.
  • tracks — array
  • service — string — Destination service. Pass only when the listener explicitly names one; otherwise OffStereo uses the active service on their account.
  • previewOnly — boolean — Resolve one unified playlist preview without saving or requiring a music-service connection. True when the listener asks to hear, inspect, or approve the songs before saving.
  • pendingActionId — string — Retry token returned by a prior auth_required result.
  • requiredArtists — array — Every artist the user explicitly requires, especially endpoints in a request such as 'from Minnie Riperton to Solange'. OffStereo validates these before creating anything.
  • allowSecondPlaylist — boolean — True only when the listener explicitly requests another separate playlist. Omit or pass false otherwise; this does not authorize a second create_playlist call in the same response.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• save_session

  Explicitly save the matched music from one listening session as a private playlist in the listener's active music service. Pass service only when the listener explicitly names Spotify or Apple Music. Unmatched songs are excluded and reported. If sign-in is needed, OffStereo preserves the request for one safe retry.

  Parameters:

  • name — string
  • service — string
  • sessionId — string
  • pendingActionId — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• prepare_episode

  Prepare one finished OffStereo story to become a private Spotify episode after the listener explicitly asks. OffStereo packages its completed intro, ordered narration, sign-off, branded title, show notes, OffStereo cover, chapters, and song timeline, then returns an honest handoff: the episode is not in Spotify until the listener finishes with Spotify's Save to Spotify helper on their own computer. Use the active or selected story's sessionId. This is for a narrated story, not a playlist or an unfinished build.

  Parameters:

  • sessionId (required) — string — The completed OffStereo story id from the active player or the listener's library.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• manage_owned_item destructive

  Manage the signed-in listener's own OffStereo stories or service playlists. Removing an OffStereo story is a recoverable archive operation, and restore brings it back. Removing an owned Spotify playlist means remove from library because Spotify does not permanently delete playlists; the operation follows an explicit confirmation turn. Apple Music's public API does not expose playlist deletion, so that case returns an honest unsupported handoff. confirm=true records explicit confirmation of the named item and operation.

  Parameters:

  • itemType (required) — string
  • id (required) — string — OffStereo session id or saved playlist id.
  • action (required) — string
  • confirm — boolean — Records the listener's explicit confirmation of the named destructive operation.
  • service — string — Required for playlists.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• get_story_audio read-only

  Get a finished OffStereo story as ONE downloadable MP3 — the narrated story, without the records. Use this on any surface where a player card cannot render: send it as a WhatsApp or Telegram voice note, attach it to an email, play it over a phone or speaker, or hand it to someone as a file. The URL is public and needs no OffStereo account, so it can be forwarded to anyone. It is narration only, which is why it is freely shareable — say so rather than promising the songs; the songs are at webUrl. Prefer this over reading a summary aloud in your own synthetic voice: this is the produced story, already voiced. Only finished shows have audio — poll get_show until status is ready.

  Parameters:

  • slug — string — The show's slug, as find_shows returns it. Use either this or showId.
  • showId — string — The show id, from find_shows, make_playable or get_show.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• my_offstereo read-only

  Call once to return the signed-in listener's OffStereo library overview, currently including their completed, unarchived shows. This is the primary personal-library tool.

  Parameters:

  • limit — number — Shows to return (1-50).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.