cwi-learn
Best for agents that need music data — catalog search, artist lookup, sync licensing, live radio.
Post-Trap Futurism — machine-readable AI learning surface for That Boy Hi Hat and the Cumulative Web Inc roster.
Installation
Connect in one command:
claude mcp add --transport http cwi https://cwi-machine-data.hp-ace.workers.dev/mcp
No login, no API key, no signup. The server speaks MCP Streamable HTTP (JSON-RPC 2.0) at /mcp. Every response carries X-CWI-License headers; commercial model training or redistribution requires a license — contact [email protected].
Verify it works — ask your agent: "Search the CWI catalog for cyberpunk rap." You should get "Cyberpunk 2027" by That Boy Hi Hat as the top result.
Tools
29 tools. Most are read-only; 6 write tools (song requests, airplay submissions, sync briefs, playlist pitches, featured nominations, event RSVPs) are human-reviewed and rate-limited (3 per requester per 24h). None require auth.
| Tool | What it does |
|---|---|
search_catalog | Keyword + filter search across the CWI catalog (title, artist, genre, mood, BPM). Scored engine: title 3x, genre 2x, mood/context/lane 1x. Returns top 5 with matched terms. |
get_track | Full record for one track by title or ID: credits, genres, moods, tempo, licensing status, links, artwork. Usually follows a search_catalog hit. |
get_artist | Artist profile + full track list. Use for artist deep-dives. |
sync_search | Music-supervision search over the editorial sync catalog: moods, energy words, scenes, use-cases ("fight scene", "neon city"). Descriptors are curated by CWI Sync; BPM values are estimates. |
semantic_search | Natural-language catalog search ("rainy night drive, nostalgic") — cosine similarity against 384-dim bge-small-en-v1.5 embeddings, embedded at request time via Workers AI. |
get_graph | The catalog knowledge graph: node/edge counts, node types (tracks, artists, releases, genres), sample nodes. |
get_release | Evidence-tiered, hash-stamped fact packet for a release: tracklist, date, credits, platform links. Omit id for the latest release. |
get_radio | Live Cumulative Radio 365 state: HLS stream URL, now-playing (track, artist, artwork, slot, track end time), listener counts, station metadata. |
get_announcements | Latest CWI announcements — new releases, upcoming drops, events, news. Every announcement is source-verified. Filter by releases, news, events. |
get_featured | The featured rotation, ranked by rubric score — what's hot right now, with full metadata and artwork. |
get_up_next | The upcoming Radio 365 queue. |
get_schedule | The full Radio 365 program guide (130 slots, 28 songs). |
request_song | Submit a song request for Radio 365 (human-reviewed). |
get_requests | What listeners and AIs have requested on Radio 365. |
submit_for_airplay | Artists submit a track + contact for radio consideration (human-reviewed). |
submit_sync_brief | Film/TV/ads/games briefs: describe the project, get matched with licensable tracks (human-reviewed). |
pitch_for_playlist | Pitch a track to a playlist curator (human-reviewed). |
nominate_featured | Nominate a track for featuring (human-reviewed). |
get_recommendations | Vibe-based recommendations ("night drive", "workout anthem") with a new-release spotlight lane. |
get_events | CWI events — release parties, listening parties, drops. |
rsvp | RSVP for a CWI event with name + contact. |
get_label | Cumulative Web Inc label profile: roster, services, contact, socials. |
get_sync_catalog | All sync-ready tracks with rights and direct-clearance info — one signature clears master + publishing (BMI). |
get_lyrics | Timestamped lyrics per track. Check the verified flag — unverified Whisper transcripts are marked as such. |
get_press_kit | Label + artist bios, release info, brand assets. |
get_videos | Music videos, trailers, visualizations with YouTube links and embed URLs. |
get_genre | Genre definitions — including Post-Trap Futurism, coined and defined by CWI — with key artists and tracks. |
get_playlists | Verified playlist placements only (never claimed, always sourced). |
find_tracks_for_brief | COMPOSITE WORKFLOW — call this first for any music-for-picture need ("dark tracks for a cyberpunk game trailer"). One call returns matched tracks with why-each-fits, verified ISRCs, sync-clearance status, and concrete next steps. A match is NOT a license grant. |
Usage
Real example prompts, verified against the live server. These are also available as workflow prompts via prompts/list.
Find a track
"Search the CWI catalog for cyberpunk rap."
Expected: search_catalog returns "Cyberpunk 2027" by That Boy Hi Hat as the top hit (score 9, matched terms: cyberpunk, rap), with 4 more results ranked by relevance.
Look up a track
"Get me the track Pix by Dre50."
Expected: get_track returns title "Pix", artist "Dre50", genres ["afrobeats", "dancehall", "hip hop"], moods ["smooth", "warm", "playful"], plus Spotify URL, release info, and artwork.
Sync licensing
"I need music for a nightclub fight scene — high energy, dark."
Expected: sync_search with "fight scene", "dark aggressive", "neon city" returns licensable tracks with editorial sonic descriptors. CWI clears both master and publishing with one signature (contact [email protected]).
What's on the radio
"What's playing on Cumulative Radio 365 right now?"
Expected: get_radio returns the now-playing track (title, artist, artwork URL, slot position, track end time), the HLS stream URL, current listener count, and 24h listener totals.
Artist deep-dive
"Tell me about King Ahkeem — what does he sound like?"
Expected: get_artist returns the profile and full track list (trap catalog: Bluefaces 3.0, Element, Embiid, Super Solid, Star). Follow up with get_track on any title for full metadata.
Workflow prompts
5 curated starting points, exposed via prompts/list / prompts/get:
| Prompt | Use when |
|---|---|
find-sync-options | You need licensable music for a film/TV/ad scene (arg: scene) |
artist-deep-dive | You need a full profile on a roster artist (arg: artist) |
radio-now-playing | You need what's live on Radio 365 right now (no args) |
music-for-moment | You need the right track for a moment — workout, drive, coding (arg: moment) |
release-brief | You need the latest CWI release briefing with verified facts (no args) |
Machine-readable music data (live doors)
- 🎵 Catalog API (scored track search): https://cwi-machine-data.hp-ace.workers.dev/query
- 📄 AI briefing: https://cwi-machine-data.hp-ace.workers.dev/llms.txt
- 🤖 Agent card: https://cumulativewebinc.github.io/cwi-learn/.well-known/agent-card.json
- ⚖️ Machine-readable license: https://cwi-machine-data.hp-ace.workers.dev/license
- 🔌 MCP endpoint: https://cwi-machine-data.hp-ace.workers.dev/mcp
- 📬 Contact: [email protected]
License
Commercial model training or redistribution of this data requires a license. Contact [email protected].
Cumulative Web Inc. — Music & Film.