# Mixcloud Shows & Mixes AI Agent Connect

> Mixcloud as an MCP: search DJ mixes, radio shows and podcasts, get full cloudcast details with tracklists, browse uploader catalogues and 38 genre categories — public read-only API, no key needed.

## Overview
- **Category:** audio-music
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QudslSsxpShyW8iYWlU7ZIVmfeYSpV5KjIHhBxxZ/ai-agent-connect
- **Tags:** mixcloud, dj-mixes, radio-shows, podcasts, tracklists, music-discovery

## Description

**Mixcloud** — the home of DJ mixes, radio shows and long-form podcasts — as a single MCP server.

### What you can do
- **Search cloudcasts** — DJ sets, radio shows and podcasts by keyword, with play/favourite counts and audio length
- **Tracklists** — cloudcast details include the sections array (tracklist with timestamps when uploaded)
- **Uploader catalogues** — browse the entire show archive of any radio station, DJ or label
- **38 genre categories** — ambient to drum-and-bass to house: genre-based discovery with paging

### Why Mixcloud?
Unlike other audio platforms, Mixcloud specialises in **long-form audio with licensed tracklists** — the only place where commercial DJ sets and radio shows are legal. Its public API needs no key for discovery.

### Who is this for?
Music supervisors, DJs, radio producers, playlist curators, event promoters and AI agents that search curated audio shows by genre, uploader or tracklist.

## Tools

### get_cloudcast
Keys come from search/list tools (format /user/slug/).

Get full cloudcast detail: tracklist sections, description, tags, stats

### get_user
username is the URL slug (e.g. Radio_RapTz from search_uploaders).

Get a Mixcloud uploader profile: bio, follower count and stats

### search_cloudcasts
Pagination via limit/offset. Note: no total count is returned — page until empty.

Search DJ mixes, radio shows and podcasts (cloudcasts) by keyword on Mixcloud

### search_uploaders
Search radio stations by name to explore their show archives.

Search Mixcloud users: DJs, radio stations, labels and podcast creators

### browse_category
Use for genre-based discovery: "what's new in drum and bass?".

Browse Mixcloud genre categories (38: ambient, bass, beats, dnb...) and their trending cloudcasts

### list_user_cloudcasts
Each entry: key (for get_cloudcast), name, play counts, tags, audio length. Great for exploring a radio station's full show archive.

List all cloudcasts (shows/mixes) published by a Mixcloud user

## Prompt Examples

**Prompt:** 
```
Find lo-fi jazz mixes on Mixcloud
```

**Response:** 
```
📻 **Cloudcast search: lo-fi jazz**

Top results:
- Groove Caché #8 Lo-Fi Jazz by MoFo (Radio_RapTz) — 848 plays, 1h30
- Lo-Fi Jazz Study Session — 12k plays

All with tracklist sections where provided. Want me to pull the full tracklist of the first one?
```

**Prompt:** 
```
Explore the drum-and-bass category — what's trending?
```

**Response:** 
```
🎧 **Category: drum-and-bass**

Browse via /categories/dnb/cloudcasts/ with offset paging:
- Weekly hospital records shows
- Classic 1990s jungle sets
- Liquid DNB megamixes

The category listing includes play counts for trend ranking. Want the top 10 by plays?
```

**Prompt:** 
```
Explore Radio RapTz's full show archive
```

**Response:** 
```
📻 **Radio RapTz — 7132 cloudcasts, 13.4k followers**

Full archive browseable with pagination: Underground Soundz Vol. 123 ft. Dj Halabi, Groove Caché series, weekly radio shows...

I can page through the entire catalogue, or pull the tracklist of any individual show.
```

## Frequently Asked Questions

**Do I need an API key?**
Not for any discovery tool in this MCP — search, cloudcast details, user profiles, catalogues and categories are all public. An access token is only required if you want /me endpoints (your own favourites and uploads), which this MCP exposes as an optional credential.

**How do I get a tracklist for a show?**
Use get_cloudcast with the cloudcast key from search results — the detail response includes the sections array, which is the tracklist with start-time offsets when the uploader timestamped their show.