Skip to content

v0.4.0 — Cover Story

Choose a tag to compare

@jamiew jamiew released this 30 Jul 19:25
· 49 commits to main since this release

Nine new tools covering playlist cover art, following, saved albums and artist discographies — plus a fix for an auth bug that made every one of them unreachable.

Highlights

  • Playlist cover art: set_playlist_cover replaces a playlist's artwork. It takes an https URL rather than image data, because Spotify wants base64-encoded JPEG in the request body and 256 KB of that is roughly 340,000 characters — not something a model can pass as a tool argument. The Worker fetches, checks the type, encodes and enforces the cap.
  • Following: get_followed_artists, follow_artists, unfollow_artists, and follow_playlist — which had been missing opposite unfollow_playlist since the first release.
  • Saved albums: get_saved_albums, save_albums, remove_saved_albums. The library previously covered tracks only.
  • Artist discography: get_artist_albums, filterable by album, single, compilation or guest appearance. Spotify withdrew artist top-tracks from third-party apps, so this is the only way left to walk a catalog.
  • Scope upgrades now take effect: the agent seeded its Spotify token once and refreshed that grant forever, so re-authorizing after a scope change did nothing — a refresh only ever returns the scopes the original token was minted with. It now records the granted scopes and adopts a fresh grant when they differ.

Also in this release

  • unfollow_playlist gained the /me/library fallback the other library writes already had, so it survives a flip to Spotify's restricted regime.
  • A 403 caused by a missing scope now says to reconnect and re-authorize, instead of the generic "the account may lack access".
  • package.json said 0.2.0 while the server reported 0.3.0 to clients. Both are 0.4.0, and check:meta now fails if they drift.
  • Removed savedTracksContain, implemented but never registered as a tool.
  • PLAN.md records the API surface deliberately left out — podcasts, audiobooks and chapters, the contains family, following users, reading playlist images — each with the reason, plus which tools are most at risk if this app is moved to Spotify's restricted regime.

All 33 tools were verified against the deployed Worker with live MCP calls, not just the test suite.

3 commits since dbb6931