
Listenbrainz
Gateway tools giving AI clients read access to ListenBrainz open music listening data
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Listenbrainz
Listenbrainz is a freemium MCP server for music creation. It can run locally on your machine or as a hosted remote server.
The Pipeworx pack wraps ListenBrainz, the open listening-history service from MetaBrainz, so an AI client can query sitewide top artists, a named user's recent scrobbles, a user's currently playing track, and a named user's top artists. Results are linked to MusicBrainz data, and the README says the public-profile lookups need no key.
The server is hosted at a Pipeworx gateway endpoint and can be reached over streamable HTTP or through a local npm stdio bridge that forwards calls to that gateway. The README says anonymous use is capped at 50 calls a day, while a free Pipeworx account raises the cap to 200.
The README warns that user-specific tools should only run when a real username is named in the request, and it directs general music-chart questions to a separate Last.fm pack. It is aimed at developers and agent builders who want listening-data lookups without wiring up the ListenBrainz API themselves.
Install
Run in a terminal
claude mcp add --transport http listenbrainz https://gateway.pipeworx.io/listenbrainz/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/listenbrainz/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"listenbrainz": {
"url": "https://gateway.pipeworx.io/listenbrainz/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"listenbrainz": {
"type": "http",
"url": "https://gateway.pipeworx.io/listenbrainz/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"listenbrainz": {
"serverUrl": "https://gateway.pipeworx.io/listenbrainz/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"listenbrainz": {
"type": "http",
"url": "https://gateway.pipeworx.io/listenbrainz/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- top_artists
- ListenBrainz sitewide top artists for a time range.
- user_listens
- A named ListenBrainz user's recent listens, newest first.
- now_playing
- What a ListenBrainz user is currently listening to, if anything.
- user_top_artists
- A named ListenBrainz user's top artists for a time range.
What it does
- Sitewide top artists
- Returns the most-listened artists across all ListenBrainz users for a chosen time range.
- User listen history
- Lists a named user's recent track scrobbles, newest first.
- Now playing lookup
- Shows the track a public ListenBrainz profile is currently playing, if any.
- Per-user top artists
- Returns a named user's most-listened artists for a time range.
- Flexible connection options
- Connects via a hosted streamable HTTP endpoint or a local npx stdio bridge.
Good for
- Pull the most-listened artists on ListenBrainz for a given week to feed a music trends report
- Check what a specific ListenBrainz user has played recently inside a music app or chatbot
- Show a user's top artists over a chosen period in a personal listening summary
- Add open listening data to an agent workflow that also uses MusicBrainz identifiers
Pricing
Freemium
Anonymous use capped at 50 calls/day; free account 200 calls/day; paid tiers on the Pipeworx gateway.
Prices change. Check pipeworx.io before you buy.
Listenbrainz FAQ
Does it require an API key?
The README says public-profile lookups are keyless. An optional Pipeworx API key raises the daily call cap from 50 to 200 on a free account.
What tools does the server expose?
The README lists four pack tools: top_artists, user_listens, now_playing and user_top_artists. The endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.
Can I use it for general music charts?
The README says general chart questions should use the separate Last.fm pack instead, and user_top_artists should only run when a real username is named.
Is it affiliated with ListenBrainz?
No. The README states it is an independent, unofficial integration and not endorsed by or published by the upstream provider.
Is Listenbrainz free?
Listenbrainz has a free plan, with paid plans for more usage or features.
How do I add Listenbrainz to Claude Code?
Run this command in your terminal: claude mcp add --transport http listenbrainz https://gateway.pipeworx.io/listenbrainz/mcp
What are the best alternatives to Listenbrainz?
The closest alternatives to Listenbrainz are Lyrics Ovh and Resident Advisor.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.