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.

Argument	Type	Description
url	string
text	string
jobId	string
notes	string
title	string
action*	string
beatId	string
changes	array
material	object
reviewId	string
sessionId	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000
    },
    "text": {
      "type": "string",
      "maxLength": 24000
    },
    "jobId": {
      "type": "string"
    },
    "notes": {
      "type": "string",
      "maxLength": 24000
    },
    "title": {
      "type": "string",
      "maxLength": 160
    },
    "action": {
      "enum": [
        "intake",
        "article",
        "review",
        "revise",
        "prepare",
        "export_video",
        "video_status",
        "credits"
      ],
      "type": "string"
    },
    "beatId": {
      "type": "string"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "beatId",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "beatId": {
            "type": "string"
          }
        }
      },
      "maxItems": 25,
      "minItems": 1
    },
    "material": {
      "type": "object",
      "required": [
        "title",
        "tracks"
      ],
      "properties": {
        "title": {
          "type": "string"
        },
        "tracks": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "artist"
            ],
            "properties": {
              "notes": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "artist": {
                "type": "string"
              }
            }
          },
          "maxItems": 12,
          "minItems": 1
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "title",
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "title": {
                "type": "string"
              }
            }
          },
          "maxItems": 20
        },
        "introduction": {
          "type": "string"
        }
      }
    },
    "reviewId": {
      "type": "string"
    },
    "sessionId": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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.

discover

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.

read-only

Argument	Type	Description
type*	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.
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.
genres*	array	Every positively requested genre; [] when the request is not genre-filtered. Results do not pad with unrelated genres.
allowSave	boolean

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.

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Artist/topic request such as 'notable samples used by Nas'."
    },
    "track": {
      "type": "string",
      "description": "Track title for a track-level lineage."
    },
    "artist": {
      "type": "string",
      "description": "Artist for a track-level lineage."
    }
  }
}

get_session

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.

read-only

Argument	Type	Description
sessionId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "sessionId"
  ],
  "properties": {
    "sessionId": {
      "type": "string"
    }
  }
}

get_story_audio

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.

read-only

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The show's slug, as find_shows returns it. Use either this or showId."
    },
    "showId": {
      "type": "string",
      "description": "The show id, from find_shows, make_playable or get_show."
    }
  }
}

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.

Argument	Type	Description
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.

manage_owned_item

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.

destructive

Argument	Type	Description
id*	string	OffStereo session id or saved playlist id.
action*	string
confirm	boolean	Records the listener's explicit confirmation of the named destructive operation.
service	string	Required for playlists.
itemType*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "itemType",
    "id",
    "action"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "OffStereo session id or saved playlist id."
    },
    "action": {
      "enum": [
        "archive",
        "restore",
        "remove"
      ],
      "type": "string"
    },
    "confirm": {
      "type": "boolean",
      "description": "Records the listener's explicit confirmation of the named destructive operation."
    },
    "service": {
      "enum": [
        "spotify",
        "apple_music"
      ],
      "type": "string",
      "description": "Required for playlists."
    },
    "itemType": {
      "enum": [
        "story",
        "playlist"
      ],
      "type": "string"
    }
  }
}

music_today

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.

read-only

Argument	Type	Description
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.
dateMode*	string	today represents the listener's current day; explicit represents one named calendar date.
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

my_offstereo

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.

read-only

Argument	Type	Description
limit	number	Shows to return (1-50).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Shows to return (1-50)."
    }
  }
}

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.

Argument	Type	Description
sessionId*	string	The completed OffStereo story id from the active player or the listener's library.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "sessionId"
  ],
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "The completed OffStereo story id from the active player or the listener's library."
    }
  }
}

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.

Argument	Type	Description
name	string
service	string
sessionId	string
pendingActionId	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "service": {
      "enum": [
        "spotify",
        "apple_music"
      ],
      "type": "string"
    },
    "sessionId": {
      "type": "string"
    },
    "pendingActionId": {
      "type": "string"
    }
  }
}

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.

Argument	Type	Description
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.
instruction*	string
activeItemId	string
playbackState	string
acknowledgeDirectiveId

OffStereo

Try it

create_authored_story

OffStereo

Try it

create_authored_story

Tools (13)