# Listenbrainz

> Listenbrainz is a freemium MCP server for music creation. Gateway tools giving AI clients read access to ListenBrainz open music listening data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/listenbrainz
- **Repository:** https://github.com/pipeworx-io/mcp-listenbrainz
- **MCP Registry name:** io.github.pipeworx-io/listenbrainz
- **Categories:** [music creation](https://ai-powered.com/categories/music-creation)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http listenbrainz https://gateway.pipeworx.io/listenbrainz/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/listenbrainz/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "listenbrainz": {
      "url": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "listenbrainz": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "listenbrainz": {
      "serverUrl": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "listenbrainz": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/listenbrainz/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Lyrics Ovh](https://ai-powered.com/mcp/lyrics-ovh): Lyrics Ovh is a freemium MCP server for music creation.
- [Resident Advisor](https://ai-powered.com/mcp/resident-advisor): Resident Advisor is a freemium MCP server for music creation.

---
Source: https://ai-powered.com/mcp/listenbrainz
