MCP server for Spotify playlist building and playback control
Strong tool coverage with 20 well-named, verb-prefixed tools (search_, get_, create_, add_, remove_, replace_, follow_, unfollow_, play_, pause_, add_to_). All tools have descriptions (avg 156 chars, within 10-1024 baseline). Input schemas present with types and defaults. However, output schemas are undocumented, no explicit return type declarations visible in code. Parameter descriptions are present but some lack format/constraint details (e.g., 'track_uri' accepts 'URI or bare ID' but no validation guidance). Error handling returns strings rather than structured errors with recovery guidance. Missing tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels assigned.
Add a track to the end of the playback queue. Requires an active Spotify device. Accepts a track URI or bare track ID.
Add tracks to a Spotify playlist. Accepts a list of track IDs or URIs (max 100 per call). Tracks are appended to the end of the playlist.
Create a new Spotify playlist for the current user. Returns the playlist ID and URI for use with other playlist tools.
Follow (save) a Spotify playlist to your library. Accepts a playlist ID or URI. Use this to save playlists found via search or shared by others.
Get all tracks on a Spotify album. Accepts a Spotify album ID or full URI. Returns track names, artists, and IDs. Useful for adding an entire album to a playlist.
Output schemas undocumented. Tools return dict/list but no explicit schema documentation visible. LLMs cannot plan downstream calls without knowing response structure.
Tool annotations missing. Tools marked with WRITE/DESTRUCTIVE risk levels but no readOnlyHint/destructiveHint/idempotentHint annotations in schema. Agents cannot distinguish safe from unsafe operations.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |
List the current user's Spotify playlists. Returns playlist names, IDs, track counts, and ownership info.
Get the current user's top artists on Spotify. time_range options: - "short_term": approximately last 4 weeks - "medium_term": approximately last 6 months (default) - "long_term": all time Useful for discovering related artists when building playlists.
Get the current user's top tracks on Spotify. time_range options: - "short_term": approximately last 4 weeks - "medium_term": approximately last 6 months (default) - "long_term": all time Useful as a seed for building personalized playlists.
Get information about the currently playing track on Spotify. Returns track name, artist, album, progress, and playback state. Returns `{"is_playing": False}` if nothing is currently playing.
Get the tracks in a Spotify playlist. Supports pagination via limit (max 100) and offset. Returns track names, artists, IDs, and total count.
Get the current user's saved (liked) tracks. Returns tracks from the user's library, sorted by most recently saved. Supports pagination via limit (max 50) and offset. A rich signal for playlist building since liked songs reflect explicit user preference.
Return the installed version of the mcp-spotify server.
Pause the current Spotify playback.
Start playing a track on Spotify. Requires an active Spotify device (open Spotify on any device first). Accepts a Spotify track URI (spotify:track:<id>) or bare track ID.
Remove tracks from a Spotify playlist. Removes all occurrences of each track. Accepts track IDs or URIs (max 100 per call).
Replace all tracks in a playlist with the given list, in order. This is useful for reordering a playlist. First get the current tracks with get_playlist_tracks, reorder the IDs as desired, then pass the full ordered list here. The playlist will contain exactly these tracks in exactly this order. Accepts track IDs or URIs. No limit on total tracks (batched internally).
Search for albums on Spotify. Returns album names, artists, release dates, and IDs. Use get_album_tracks to list the tracks on a found album.
Search for artists on Spotify. Supports the same query syntax as search_tracks. Returns artist names, genres, and IDs. Useful for finding an artist ID to explore their catalog.
Search for tracks on Spotify. Supports Spotify query syntax for filtering: - genre: "genre:rock" - year: "year:2020" or "year:2018-2022" - artist: "artist:radiohead" - combined: "genre:indie year:2020-2024" Returns track names, artists, albums, and IDs.
Unfollow (remove) a Spotify playlist from your library. For playlists you own, this is the only way to 'delete' them -- Spotify has no true delete. The playlist will no longer appear in your library or profile.
Error handling returns plain strings instead of structured errors with recovery guidance. E.g., 'Error: {e}' gives LLM no actionable next step. Should return error classification (retryable/user-fixable/fatal) and suggestions.
Parameter format constraints not documented. 'track_uri' accepts 'URI or bare ID' but no validation rules stated. 'limit' and 'offset' lack min/max bounds. LLMs may pass invalid values.
Destructive operations (unfollow_playlist) lack confirmation/dry-run pattern. Agents can permanently delete playlists without explicit user approval.