The definitive Spotify MCP server - full non-deprecated Web API coverage, paginated everything, podcast-first, tested end to end
29 tools with consistent naming (verb_noun pattern) and documented schemas. Descriptions are present but often terse (avg ~80 chars, below 194-char baseline). All tools have input schemas with types and descriptions. Output schemas are not explicitly documented in the source. Error handling is minimal, no recovery guidance or actionable error messages visible. Response format parameter is ubiquitous but adds noise. Missing tool annotations (readOnlyHint/destructiveHint) despite clear risk classification in metadata.
Add tracks to a playlist
Check if user is following artists
Check if tracks/albums/shows are in user's library
Create a new playlist
Follow artists
Get top tracks for an artist
Get list of available markets where Spotify is available
Descriptions are terse (avg ~80 chars vs 194-char baseline). Most read-only tools have 45-55 char descriptions like 'Get list of available markets', insufficient context for LLM tool selection. Should explain WHEN to call and WHAT to do with results.
No output schemas documented in source. Tools return structured content but LLMs cannot see field names, types, or required fields. Agents must infer response structure from trial and error.
Missing tool annotations. All 29 tools lack readOnlyHint/destructiveHint/idempotentHint despite clear risk classification (READ_ONLY vs WRITE). Agents cannot infer safety properties without explicit annotations.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2025-06-18+ | v2 |
Get list of browse categories
Get playlists for a specific category
Get current user profile information
Get user's recently played tracks
Get user's top artists
Get user's top tracks
Get playlists for a specific user
Get public profile information for a user
Pause playback
Start or resume playback
Remove tracks/albums/shows from user's library
Remove tracks from a playlist
Save tracks/albums/shows to user's library
Search for tracks, artists, albums, playlists, shows, and episodes
Seek to a position in the current track
Set repeat mode
Set shuffle mode
Set playback volume
Skip to next track
Skip to previous track
Diagnostic tool that checks token validity, scope coverage, premium status, and rate-limit state. Always succeeds with pass/fail/warn/info rows; report is 'ok' when no row failed.
Unfollow artists
No error recovery guidance. Tools fail silently or return generic errors. No actionable messages like 'User not found. Try search_users() first.' Agents cannot self-correct on failures.
response_format parameter is redundant on 20+ read-only tools. Adds noise and forces LLM to choose between 'json' and 'prose' on every call. Should default to structured JSON and omit the parameter.