Skip to content
MCP server

Listenbrainz

Gateway tools giving AI clients read access to ListenBrainz open music listening data

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/listenbrainz/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "listenbrainz": {
      "url": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers