spotify-api-watch

spotify-api-watch is a skill for Claude Code, Codex from jamiew/spotify-mcp. It costs 92 tokens per session (1,109 once invoked), scanned A, original, from a forked repository, MIT.

A workflow that checks Spotify Web API updates and tests whether a server still matches them. Spotify Web API is the online interface that applications use to access Spotify data and actions.

In plain words
What is it for?
It is for reviewing Spotify API change notices, identifying changes that affect the server, checking live behavior, and recording reviewed updates before a release or on a schedule.
Why use it?
Spotify can change this interface in ways that break an application, sometimes without an obvious warning. The workflow compares new change notices with the server's code and performs a live compatibility check.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/jamiew/spotify-mcp/spotify-api-watch
Any agent
npx skills add jamiew/spotify-mcp --skill spotify-api-watch
Clone the repo
git clone --depth 1 https://github.com/jamiew/spotify-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for spotify-api-watch

README.md
[![agentmods](https://agentmods.dev/badge/skills/jamiew/spotify-mcp/spotify-api-watch.svg)](https://agentmods.dev/skills/jamiew/spotify-mcp/spotify-api-watch)
Your own site
<a href="https://agentmods.dev/skills/jamiew/spotify-mcp/spotify-api-watch"><img src="https://agentmods.dev/badge/skills/jamiew/spotify-mcp/spotify-api-watch.svg" alt="Measured on agentmods" height="20"></a>
Per session 92 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,109 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin fork From a forked repository.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00092 $0.01109
Opus 5 $0.00046 $0.00554
Sonnet 5 $0.00018 $0.00222
Haiku 4.5 $0.00009 $0.00111

Measured 5d ago against content hash c555fd5fe683, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spotify-api-watch scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/spotify-api-watch/SKILL.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Spotify API watch

Spotify ships breaking changes to the Web API with little notice and no RSS feed. This skill answers two questions: what did Spotify change, and does our server still work. Do both — a clean changelog does not mean nothing broke, because the regime flip described below happens silently.

1. Changelog sweep

uv run scripts/spotify_api_watch.py

Exit 1 means there are unreviewed entries. Spotify publishes no feed and no changelog index, so this probes the predictable per-month URLs (.../references/changes/<month>-<year>) and diffs against scripts/spotify-api-seen.json.

For each NEW URL, fetch it and classify every item as:

  • Breaks us — an endpoint spotipy calls, a field one of the Pydantic models in src/spotify_mcp/fastmcp_server.py requires, or a path in the fallback layer at the bottom of src/spotify_mcp/spotify_api.py.
  • Unlocks something — new capability worth a tool or a scope.
  • Irrelevant — dashboard/quota/billing with no code impact.

Then re-run with --accept to record them as reviewed, and commit the updated JSON. Only accept after you have actually read the entries.

2. Live conformance probe

The changelog tells you what Spotify announced; this tells you what our app actually gets. Requires the server connected as an MCP client — ask the user to reconnect if the tools are absent.

Run these and compare against the expectations:

Call Full/legacy regime Restricted regime
get_me returns email, country, product id only
get_artist_info on any artist has followers, popularity both absent
search_music with limit=20 can return >10 capped at 10
save_tracks on one id succeeds via legacy /me/tracks succeeds via /me/library

If the probe shows a flip to restricted, expect these to matter:

  • search_music max drops 50 → 10 (our schema still advertises 50).
  • Artist followers/popularity and user email/country/product vanish. Those fields are all optional on the Pydantic models, so they degrade rather than throw — keep them that way.
  • Playlist and library writes move to /items and /me/library. with_fallback in spotify_api.py handles this, but it caches per process, so the first call after a flip may fail before it settles. Watch for the "resolved to the legacy regime" log line to see which way it went.

Read the full file on GitHub · 86 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 86 lines · 92 tokens per session scan A c555fd5fe683

Subscribe to this mod's changes

spotify-api-watch is a skill published in the GitHub repository jamiew/spotify-mcp (9 stars, last pushed 1mo ago), licensed MIT. It adds 92 tokens to every session and 1,109 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. It comes from a forked repository.

Related

Other skills, from other repositories

social-spotify-card

Spotify Now Playing-style card with album art, progress bar, and playback controls, suited to video overlays or personal homepages.

nexu-io/open-design · 30 tokens

social-spotify-card

Spotify Now Playing 风格卡: 专辑封面 + 进度条 + 播放控制, 适配视频叠加 / 个人主页.

nexu-io/html-anything · 38 tokens

spotatui-dj

Be the DJ for spotatui, the terminal music player, by driving its MCP server. Use whenever the user asks for music, asks you to DJ, wants tracks queued, played, skipped, or searched, asks what they have been listening to, or mentions spotatui.

LargeModGames/spotatui · 63 tokens

github-triage

Use when touching anything on the GitHub side of christosk92/WaveeMusic — labels, milestones, the "Wavee" project board (Projects v2), issue forms / PR template, CONTRIBUTING / SECURITY, repo settings, Discussions, or triaging an issue or PR with gh. Every modifying gh call needs the user's explicit approval first.

christosk92/WaveeMusic · 79 tokens

wavee-sidebar

Use when changing anything in Wavee's left sidebar — the three designs (Classic / Library V3 / Wavee Curated), the one SidebarPane renderer, the layout document + reducer + templates, the projection/binder/planner data pipeline, sidebar-layout.json persistence, the full-page customizer, pins, or the extension-platform…

christosk92/WaveeMusic · 114 tokens

releasing

Use when cutting, publishing, or troubleshooting a Wavee MSIX release — the local ops/release/wavee-release.ps1 runbook (no CI job), the wavee-v tag and the rolling wavee-stable update feed, building/signing the NativeAOT MSIX, Azure Trusted Signing failures (Invalid tenant id, SignerSign 0x80004005, publisher…

christosk92/WaveeMusic · 107 tokens