Repository navigation
v0.4.0 — Cover Story
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_coverreplaces a playlist's artwork. It takes anhttpsURL 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, andfollow_playlist— which had been missing oppositeunfollow_playlistsince 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_playlistgained the/me/libraryfallback 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.jsonsaid0.2.0while the server reported0.3.0to clients. Both are0.4.0, andcheck:metanow fails if they drift.- Removed
savedTracksContain, implemented but never registered as a tool. PLAN.mdrecords the API surface deliberately left out — podcasts, audiobooks and chapters, thecontainsfamily, 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.