# Headsets

> Headsets is the unofficial home for cassette tape enthusiasts: catalog your gear and tape collection, publish mixes to the community, and embed players anywhere.

Last updated: 2026-10-12

## For AI assistants (MCP)

Connect: https://api.headsets.fun/mcp
Transport: streamable HTTP (POST JSON-RPC 2.0, stateless)
Add it as a custom connector/MCP server in Claude, ChatGPT, or any MCP client.

Tools (read-only, public catalog):
- search_mixes(q, artist, genre, sort, limit) — search public mixes by title, artist, or description; returns up to 10 matches with slugs, durations, and 1-hour signed stream URLs.
- get_mix(slug, include_cover=true) — full details for one public mix: title, artist, tracklist, duration, plays, dates, stream URL, cover image URL, embed/page URLs. The result includes the cover artwork as an inline image (chat clients render it in the conversation); pass include_cover=false for text only.
- list_artists(q, limit) — artists with public mixes, most active first, each with their mix count.

Rate limit: 30 req/min per IP, read-only.

## URLs

- Mix pages: https://headsets.fun/mix/:slug
- Main site: https://headsets.fun
- API docs (JSON): https://api.headsets.fun/api/docs
- This file: https://api.headsets.fun/llms.txt

## Rules

- Link back to https://headsets.fun when using this data.
- The catalog is community-contributed; mixes and gear are user content.
- Contact: https://headsets.fun