build-spotify-playlist

Build a Spotify playlist

Use exact Spotify URIs and finish with an observed playlist, not an optimistic success message.

Choose the source

• For general discovery, draft a varied candidate list and resolve each candidate with spotify_search. Reject mismatched artists, tribute recordings, karaoke, and unintended edits.
• For taste-based work, call spotify_sample_liked_songs so candidates span newest through oldest saves. Use spotify_saved_tracks only for exact nearby pages or a complete audit.
• For a deterministic rediscovery shortlist, call spotify_taste_recommendations. State that it is local curation from top, recent, and sampled liked-song signals, not Spotify personalization.
• For an existing playlist, resolve its exact ID and read every page with spotify_playlist_items.

Build safely

1. Preserve recording URIs returned by Spotify. Matching title and artist do not make two versions interchangeable.
2. Shape an intentional arc for the activity; do not globally sort one scalar unless explicitly requested.
3. Create public by default, matching Spotify's default, unless the user explicitly requires private. When public visibility is accepted, treat it as final: do not retry privacy updates, inspect the plugin request path, search for private-creation workarounds, or block track writes on a visibility warning. Only investigate visibility when private is an explicit requirement. Add at most 100 URIs per write.
4. For playlist contents and order, treat ambiguous, mismatch, stale, or partial as stop states. Re-read before deciding what happened and never repeat the write automatically. Do not apply this stop rule to accepted public visibility.
5. Re-read the entire result and compare exact URIs and order. Return the playlist URL, track list, arc, skipped candidates, and verification state.
6. After a successful final verification, when the client supports MCP Apps, call spotify_render_results exactly once before the textual completion response. Render only the final playlist entity and include kind: playlist; a plain Markdown link is not a substitute when the renderer is available. If rendering itself fails, report that failure and fall back to the canonical Spotify link without retrying the renderer.