Bandcamp crate digging MCP server

bandcamp-mcp

Dig through Bandcamp by talking to Claude: chase a label's roster, see what is new under a tag, pull up an album's tracklist and price, and find who actually made track 7 on that compilation. bandcamp-mcp is a local MCP server — the way an AI assistant reaches tools on your machine — so any MCP client can use it: Claude Desktop, Claude Code, Cursor, VS Code. No account, no API key, nothing to configure.

Status: experimental. Pre-1.0 and actively developed: a minor version may change behaviour or break compatibility, a patch never does. Only the latest release is supported.

Not affiliated with, endorsed by, or sponsored by Bandcamp.

What you can ask

track lengths."

• "What's in the Sacred Bones catalogue, and who is each release by?"
• "Find the album Cathedral by John Carpenter and read me the tracklist with

tell me its label and release date."

• "Show me ten new releases under the tag drum-bass, then open each one and

has released."

• "Is that compilation various-artists? Tell me who made each track."
• "How much is this album, and is it name-your-price?"
• "Find that Bandcamp link a friend sent me and tell me what else the artist

Answers come from Bandcamp's own public pages, fetched live — one request per tool call the assistant makes. The server reads; it never buys, downloads or touches an account, and it has no field in which a stream or download link could reach you.

Install

npx is the whole install: your MCP client starts the server on demand and picks up fixes the next time it launches.

Claude Code:

claude mcp add bandcamp -- npx -y bandcamp-mcp

Claude Desktop (Settings → Developer → Edit Config), or any MCP client that starts a stdio server from a command:

{
  "mcpServers": {
    "bandcamp": {
      "command": "npx",
      "args": ["-y", "bandcamp-mcp"]
    }
  }
}

Cursor: install in Cursor, or add the same JSON block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode): install in VS Code, or run code --add-mcp '{"name":"bandcamp","command":"npx","args":["-y","bandcamp-mcp"]}'.

Claude Code plugin: this repository is also a plugin (.claude-plugin/plugin.json), so /plugin can install it once it is listed.

Requirements, and what is actually tested

Node.js 20 or newer (22 LTS recommended); Node 18 is end-of-life and a dependency of the MCP SDK requires 20. Every push runs the test suite on Node 20, 22 and 24, then packs the package, installs it into an empty project and starts it through an MCP handshake on Linux, macOS and Windows, on each of those Node versions. Nothing else is claimed: other platforms may well work, but no one has measured them.

Bandcamp itself has no versioned API. What the server reads is whatever bandcamp.com serves today, which is why a smoke test runs against the live site daily (badge above) and why a tool can start failing without warning — see How this works.

Shortened. The full README is on GitHub.