Skip to main content
Glama

Save the story playlist

save_session

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

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "save_session"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNo
serviceNo
sessionIdNo
pendingActionIdNo

Output Schema

NameRequiredDescriptionDefault
idNo
titleNo
objectYesAlways 'playlist'.
statusYespreview, preview_partial, saved_offstereo, created, partial, auth_required, or failed.
tracksNo
webUrlNo
actionsNo
messageNo
privacyNoRequested vs. confirmed privacy state.
serviceNo
spotifyNo
warningsNo
retryToolNo
appleMusicNo
authReasonNo
connectUrlNoSign-in URL when status is auth_required.
unresolvedNoSongs that could not be confidently matched.
connectionsNo
pendingActionIdNoRetry token for a safe re-call after sign-in.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedOutput schema / description
      Previous value: -"A playlist result. status is preview (unsaved, hearable), created, partial, auth_required, or failed. Songs that could not be matched are reported in `unresolved` rather than substituted."New value: +"A playlist result. status is preview (unsaved, hearable), preview_partial, saved_offstereo (private library snapshot, no music-service write), created, partial, auth_required, or failed. Songs that could not be matched are reported in `unresolved` rather than substituted."
    • changedOutput schema / properties / service / enum
      Previous value: -[
      -  "spotify",
      -  "apple_music"
      -]New value: +[
      +  "spotify",
      +  "apple_music",
      +  "offstereo"
      +]
    • changedOutput schema / properties / status / description
      Previous value: -"preview, created, partial, auth_required, or failed."New value: +"preview, preview_partial, saved_offstereo, created, partial, auth_required, or failed."
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources