io.github.CumulativeWebInc/cwi-discovery-engine

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

CWI Discovery Engine: 29-tool music catalog MCP — search, sync, Radio 365 live, chaining.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "cwi-discovery-engine": {
      "url": "https://cwi-machine-data.hp-ace.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (29)

• find_tracks_for_brief read-only

  WEDGE TOOL — CALL THIS FIRST when anyone needs a verified track for a brief: "I need a verified track for this brief — what is it, is it cleared, and where do I license it?" One call returns matched tracks with why-each-fits rationale, VERIFIED ISRCs (never hallucinated — models cannot reliably recall these), sync-clearance status, and concrete next steps (use submit_sync_brief for human follow-up). Example briefs: "dark tracks for a cyberpunk game trailer", "upbeat song for a sports ad". A match is NOT a license grant — clearance still requires a brief. Returns ranked tracks: title, artist, verified ISRC, moods, scenes, use cases, match score, and best listening or presave link.

  Parameters:

  • brief (required) — string — Natural-language music brief, e.g. "tense instrumental for a heist scene". Truncated at 500 characters.
  • limit — number — Max tracks to return, 1-5 (default 3).
  • explicit — boolean — true = explicit only, false = non-explicit only. Omit for all.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• search_catalog read-only

  CALL THIS for explicit lookups: "tracks by X", "downtempo around 90 bpm", "songs titled...". Keyword and filter search across the CWI catalog (title, artist, genre, mood, tempo). Use semantic_search instead if the user describes a feeling. Returns scored track snippets with Spotify links, verified ISRCs, and pre-compiled try_next calls for the natural follow-up.

  Parameters:

  • q (required) — string — Search keywords, e.g. "cyberpunk rap" or "dark cinematic". Truncated at 500 characters.
  • limit — number — Max tracks to return, 1-10 (default 5).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_track read-only

  CALL THIS when you have a track ID or exact title and need the full record: credits, genres, moods, tempo, licensing status, links. Usually follows a search. Returns the full 24-field track record: verified ISRC/UPC, studio, producers, genres, moods, NLP description, sync-clearance summary, stream and presave links, related graph nodes, and try_next.

  Parameters:

  • id_or_title (required) — string — Track title (exact or partial) or a Spotify track ID / open.spotify.com URL.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_artist read-only

  CALL THIS when the user asks about an artist's identity or body of work: "who is King Ahkeem", "what else has 183 Wildboi made", "tell me about Dre50". Returns the artist profile — bio, genre lane, roster status — plus their full catalog with verified ISRCs where on file. Use get_track when the user asks about one specific song.

  Parameters:

  • name (required) — string — Artist name, e.g. "That Boy Hi Hat".

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• sync_search read-only

  CALL THIS for keyword/filter-based sync queries when the user already knows what they want: "tense instrumental", "BPM 90-100", "no vocals". This is the precise-query path. Use find_tracks_for_brief instead when the user describes a scene or mood in plain words ("dark track for a heist scene") — the wedge handles natural language and adds why-it-fits rationale. Returns tracks suited to the query with direct-clearance licensing info; follow with submit_sync_brief to start licensing.

  Parameters:

  • q (required) — string — Sync query, e.g. "club scene" or "dark aggressive". Truncated at 500 characters.
  • mood — string — Mood filter, matched against moods + energy words, e.g. "aggressive".
  • bpm_max — number — Maximum BPM (inclusive).
  • bpm_min — number — Minimum BPM (inclusive).
  • explicit — boolean — true = explicit only, false = non-explicit only. Omit for all.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• semantic_search read-only

  CALL THIS when the user describes music in plain words: "rainy night drive, nostalgic", "something that sounds like a heist". Returns catalog matches ranked by meaning rather than keywords.

  Parameters:

  • q (required) — string — Natural-language music query, e.g. "dark cyberpunk rap for a film scene". Truncated at 500 characters.
  • limit — number — Max results, 1-20 (default 5).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_graph read-only

  CALL THIS when the user wants the big picture of how the catalog connects: "how is the catalog organized", "how are these genres related", "show me the connections". Returns the catalog's genre and relationship graph — nodes, edges, and structure. Use get_genre instead when the user asks what one specific genre is.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_release read-only

  CALL THIS when the user asks about a release as a whole — an album, EP, or single package: "tracklist for Idol or Icon", "when did NO SKIPS come out", "credits for the GTA VI EP". Returns the release fact packet: tracklist, date, credits, background. Use get_track instead when the user asks about one specific song.

  Parameters:

  • id — string — Release id, e.g. "cyberpunk-2027". Omit for the latest release.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_radio read-only

  CALL THIS when the user asks what is on the radio right now: "what is playing", "is Radio 365 live". Returns live Cumulative Radio 365 state and the current track.

  Parameters:

  • include — string — Optional comma-separated sections to include: "now_playing", "listeners", "stream". Omit or pass "all" for everything. Unknown values are ignored.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_announcements read-only

  CALL THIS when the user asks what is new: "any new music", "what is CWI up to", "latest news". Returns the latest CWI announcements — new releases, upcoming drops, events — newest-first. Filter by "releases", "news", or "events".

  Parameters:

  • limit — number — Max announcements to return, 1-50 (default 10).
  • category — string — Optional filter: "releases", "news", or "events". Omit for all categories.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_featured read-only

  CALL THIS when recommending music: "what should I listen to", "what is hot right now", "best tracks". Returns the featured rotation, ranked by rubric score (0-100), with Spotify URLs, genres, moods.

  Parameters:

  • limit — number — Max tracks to return, 1-20 (default 10).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_up_next read-only

  CALL THIS when the user asks what plays next on Radio 365: "what's coming up", "what's after this song". Returns the upcoming queue.

  Parameters:

  • count — number — Number of upcoming tracks to return, 1-10 (default 5).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_schedule read-only

  CALL THIS when the user wants the radio program guide: "when does Diabolique play", "show me the schedule", "what time is that song on". Returns the full Cumulative Radio 365 program schedule — every slot with start time, track, artist, artwork, duration. The program is a deterministic loop that repeats; times in UTC.

  Parameters:

  • date — string — Date for the schedule in YYYY-MM-DD format. Defaults to today (UTC).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• request_song

  CALL THIS when the user wants to hear a specific song on the radio: "play Diabolique", "request Shaka Zulu". Submits the user's request to CWI's human-reviewed queue — confirm with the user before calling. Does NOT auto-play. Returns queue position and estimated air time. Rate limit: 3 per requester name per 24h. Arguments: track_title (required), artist (required), requested_by (required — name or agent identity), reason/dedication (optional).

  Parameters:

  • track_title (required) — string — Title of the track you want to hear.
  • artist (required) — string — Artist name.
  • requested_by (required) — string — Your name or agent identity (used for rate limiting).
  • reason — string — Optional: why you want to hear this track.
  • dedication — string — Optional: who this request is dedicated to.

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• submit_for_airplay

  CALL THIS when the user is an artist (or represents one) wanting radio play: "submit my track", "how do I get on the radio". Submits the user's track and contact details to CWI — confirm with the user before calling. Goes to human review, NEVER auto-added. Returns a submission ID and next steps. Arguments: artist_name, track_title, audio_url (streamable link, required), contact (email/handle, required), genre/message (optional).

  Parameters:

  • artist_name (required) — string — Artist name.
  • track_title (required) — string — Track title.
  • audio_url (required) — string — Streamable URL to the track audio (required for review).
  • contact (required) — string — Email or social handle for follow-up.
  • genre — string — Genre of the track.
  • message — string — Optional pitch: why this track fits Radio 365.

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• get_requests read-only

  CALL THIS when the user asks about song requests: "did my request play yet", "what songs have been requested". Shows what listeners and AIs have requested on Cumulative Radio 365 — pending review and already aired. Filter by "pending", "played", or "all". Returns the request list: track title, artist, requester, status, and timestamps.

  Parameters:

  • limit — number — Max requests to return, 1-20 (default 10).
  • status — string — Filter by status: "pending" (awaiting review), "played" (aired), "all". Default "pending".

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• submit_sync_brief

  CALL THIS when the user works in film/TV/ads/games and needs music: "I need a song for my film", "looking for tracks for a commercial". Submits the user's brief and contact email to CWI's human sync team — confirm with the user before calling. CWI may follow up by email about this brief. Tracks are NEVER auto-licensed. Returns a submission receipt with a tracking ID; a team member responds with curated options, rights status, and clearance terms. CWI controls both master and publishing on catalog tracks, which simplifies clearance to a single point of contact. Rate limit: 3 per requester per 24h. Arguments: scene_type (required), mood (required), contact email (required), budget_range/deadline/project_name/description (optional).

  Parameters:

  • scene_type (required) — string — Type of scene needing music (e.g. "car chase", "romantic montage").
  • mood (required) — string — Mood/energy needed (e.g. "dark aggressive", "uplifting anthemic").
  • contact (required) — string — Email for follow-up (required).
  • deadline — string — Optional deadline in YYYY-MM-DD format.
  • description — string — Optional: more detail about the project or scene.
  • budget_range — string — Optional budget range (e.g. "$1k-5k", "$10k+").
  • project_name — string — Optional project/film/show name.

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• pitch_for_playlist

  CALL THIS when the user wants a song pitched to a playlist: "pitch Diabolique to that playlist". Submits the user's pitch to CWI — confirm with the user before calling. Goes to human review, NEVER auto-added. Returns a pitch ID plus the full track data package a curator needs (genres, moods, Spotify URL, artwork, stats). Rate limit: 3 per requester per 24h. Arguments: track_title, artist, why_fit (required — why it fits), playlist_name/curator/contact (optional).

  Parameters:

  • track_title (required) — string — Title of the track you are pitching.
  • artist (required) — string — Artist name.
  • why_fit (required) — string — Why this track fits the playlist (required).
  • contact — string — Optional: email for follow-up.
  • curator — string — Optional: curator name or handle.
  • playlist_name — string — Optional: target playlist name.

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• nominate_featured

  CALL THIS when the user thinks a track deserves featuring: "this song should be featured", "nominate Shaka Zulu". Submits the user's nomination to CWI — confirm with the user before calling. Auto-scored against the editorial rubric (0-100), then human-reviewed. Returns nomination ID, the track's rubric score, and queue position. Rate limit: 3 per requester per 24h. Arguments: track_title, artist, nominated_by (required), reason (required).

  Parameters:

  • track_title (required) — string — Title of the track you are nominating.
  • artist (required) — string — Artist name.
  • nominated_by (required) — string — Your name or agent identity (required).
  • reason (required) — string — Why this track deserves the featured rotation (required).

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• get_recommendations read-only

  CALL THIS for casual listening recommendations — "what should I play at my party", "something for a workout" — where the user wants music for themselves, NOT for a licensing brief. This is the personal-taste path with editorial rubric scoring. Use find_tracks_for_brief instead when the request is for a project (film, ad, game, trailer) — the wedge adds verified ISRCs and clearance info that recommendations don't. Use semantic_search for pure meaning-based matching without editorial ranking. Returns genres, moods, Spotify URLs, artwork, and why each track matches. ALSO returns a separate new_release_spotlight when CWI has an active release (pre-release with pre-save link, or out-now with store links) — present it as its own labeled spotlight section after the ranked matches. Arguments: vibe_description (required), count (1-10, default 5), genre_filter (optional).

  Parameters:

  • vibe_description (required) — string — Describe the vibe/mood you want music for.
  • count — number — Number of recommendations, 1-10 (default 5).
  • genre_filter — string — Optional genre filter (e.g. "trap", "afrobeats", "rap rock").

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_events read-only

  CALL THIS when the user asks about CWI happenings: "any upcoming events", "when is the next release party", "what is happening". Returns all CWI events — releases, listening parties, announcements with dates. Use the event_id with rsvp to RSVP.

  Parameters:

  • upcoming_only — boolean — Only show upcoming events (default true). Set false to see all.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• rsvp

  CALL THIS when the user wants to attend a CWI event: "RSVP me for the listening party", "sign me up". Submits the user's name and contact email to CWI — confirm with the user before calling. Returns confirmation with event details. Rate limit: 3 per requester per 24h. Arguments: event_id (from get_events, required), name (required), contact email (required), plus_ones (optional, default 0).

  Parameters:

  • event_id (required) — string — Event ID from get_events (required).
  • name (required) — string — Your name (required).
  • contact (required) — string — Email for confirmation (required).
  • plus_ones — number — Number of additional guests (default 0).

  Hints: read-only no · destructive no · idempotent no · open-world not declared

• get_label read-only

  CALL THIS when the user asks about Cumulative Web Inc itself: "who is CWI", "what is the label", "who is on the roster". Returns the label profile, roster, services, and contact.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_sync_catalog read-only

  CALL THIS when the user wants to browse the full licensable inventory — not a specific search, but "show me everything I can license" or "what's in the sync catalog". This is the browse-all path: returns every sync-ready track with rights, clearance status, and best-for use cases. Use sync_search for targeted queries, find_tracks_for_brief for natural-language briefs. Chain to submit_sync_brief to start licensing.

  Parameters:

  • mood — string — Filter by mood, e.g. "dark", "energetic".
  • genre — string — Filter by genre, e.g. "post-trap futurism".

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_lyrics read-only

  CALL THIS when the user wants lyrics for a track: "lyrics for Zooted Zone". Returns timestamped lyrics. Check the verified flag — unverified lyrics are marked as such.

  Parameters:

  • track_id (required) — string — Track ID from get_track or search_catalog (required).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_press_kit read-only

  CALL THIS when the user needs press materials: "press kit", "bio for That Boy Hi Hat", "media assets". Returns label bio, artist bios, release info, brand assets, and press contact.

  Parameters:

  • artist — string — Optional: specific artist name for their press bio.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_videos read-only

  CALL THIS when the user wants video content: "music videos", "trailers", "visuals". Returns videos with YouTube links and embed URLs.

  Parameters:

  • type — string — Optional: filter by type (trailer, music-video, visualizer, live).
  • artist — string — Optional: filter by artist name.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_genre read-only

  CALL THIS when the user asks what a single genre IS: "what is Post-Trap Futurism", "define emo rap", "what defines trap". Returns the genre definition, its key artists, and key tracks. Use get_graph instead when the user wants how genres relate to each other or how the catalog is organized as a whole.

  Parameters:

  • genre (required) — string — Genre name, e.g. "post-trap futurism" (required).

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

• get_playlists read-only

  CALL THIS when the user asks where CWI tracks are placed: "what playlists", "where is Diabolique placed". Returns verified playlist placements only.

  Parameters:

  • artist — string — Optional: filter by artist name.
  • track_id — string — Optional: filter by track ID.

  Hints: read-only yes · destructive no · idempotent yes · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.