⚡ Model Context Protocol Server v1.0.0

SpotCheck MCP server
for AI agents

Equip Claude, Cursor, LangChain, and autonomous music promotion agents with real-time Spotify playlist validation, bot risk scoring, curator contact extraction, and 24/7 cloud monitoring.

Get Setup in 2 Minutes →Authorize OAuth Demo

1-Click Client Configuration

Choose your runtime or IDE below to copy the connection snippet.

Terminal

claude mcp add --transport http spotcheck https://spotcheck.cc/api/mcp

💡 Run once. Nothing to install. For the warning-triage and playlist-vetting procedures, also run /plugin marketplace add chrisschouk/SpotCheck-skills.

Full API Parity for Agents

Every capability from our web app and Chrome extension, available via standard MCP tools.

🎯

Bot Risk Scoring

0–100 risk score based on follower-to-track ratios, round follower increments, generic title patterns, and 30-day historical snapshot trends.

📬

Curator Contacts & Tips

Parses public submission emails, Instagram/TikTok handles, and submission forms. Matched against researched pitch recommendations.

📡

24/7 Cloud Monitoring

Automated daily snapshot scraping for up to 25 target playlists. Detects inorganic spikes, sudden drops, and track placement alerts.

Free skills pack

Five agent skills for artists dealing with fake Spotify streams: warning triage, a playlist verdict, red flags, a pitch check and a handoff to SpotCheck. Free on GitHub under MIT.

Get the skills pack on GitHub

Interactive Tool Reference

Inspect parameter definitions, return payloads, annotations, and error codes for all 6 tools.

Tools Catalog (6)

check_playlist

Free

Evaluates public Spotify playlist data against inorganic growth patterns, follower-to-track ratios, round follower counts, generic naming patterns, and follower trend snapshots. Outputs a 0-100 risk score and risk rating (low, medium, high, editorial). Free accounts receive the headline score, verdict, and the primary warning factor; Pro/Premium accounts receive full factor breakdowns and 30-day historical follower trend series.

Parameters

playlist(string)REQUIRED

Spotify playlist URL, Spotify URI, or bare 22-character alphanumeric playlist ID.

Example: https://open.spotify.com/playlist/1PmwMQY86pJuAm7veFt3u2

Return Schema (object)

Analysis payload containing playlist metadata, risk score, factor breakdown, and trend history.

playlist.id (string) — Canonical 22-character Spotify playlist ID.
playlist.name (string) — Playlist display title.
playlist.curator (string) — Curator display name from Spotify profile.
playlist.followers (number) — Total public follower count.
playlist.tracks (number) — Total track count in playlist.
botRisk.score (number) — Calculated risk score from 0 (safest) to 100 (highest risk).
botRisk.level (string) — Risk band: "low", "medium", "high", or "editorial".
botRisk.factors (array) — Array of detected risk heuristic factors with descriptions.
botRisk.lockedFactors (number) — Count of additional factors locked on Free tier.
snapshots (array) — Follower count history points (available on Pro/Premium).

Store-Compliant & Secure by Design

Ready for the Anthropic MCP Registry, OpenAI Actions, and enterprise agent runtimes. Built with OAuth 2.1 PKCE (S256), strict Zod schemas, deterministic tool annotations, and server-authoritative rate limits.

/.well-known/oauth-authorization-server /.well-known/mcp/server-card.json

SpotCheck MCP server for AI agents