discogs-mcp

A Model Context Protocol server for Discogs. Search the catalog, manage your collection and wantlist, and work the marketplace — straight from Claude or any other MCP client. No hosting required: it runs locally via npx and talks to Discogs' own API directly.

Features

Related MCP server: MusicBrainz MCP Server

Quick start — personal access token (recommended)

The simplest setup: no app registration, no OAuth flow, just one token.

1. Go to discogs.com/settings/developers and click Generate new token under Personal access tokens.

2. Add discogs-mcp to your MCP client with that token.

Claude Code

claude mcp add discogs -e DISCOGS_PERSONAL_TOKEN=your_token -- npx -y discogs-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": ["-y", "discogs-mcp"],
      "env": {
        "DISCOGS_PERSONAL_TOKEN": "your_token"
      }
    }
  }
}

Restart your client and the discogs_* tools will appear.

Alternative — OAuth app (for multi-user or CI setups)

If you need to authenticate as a different Discogs user than the token owner, or want to use OAuth 1.0a app credentials instead:

1. Register a free application at discogs.com/settings/developers — any name works; grab the Consumer Key and Consumer Secret.

2. Run the login flow to authorize and save an access token:

export DISCOGS_CONSUMER_KEY=your_consumer_key
export DISCOGS_CONSUMER_SECRET=your_consumer_secret

npx discogs-mcp login

This opens your browser to Discogs' authorization page and saves the access token to ~/.config/discogs-mcp/credentials.json (mode 0600). You only need to do this once.

Then add to your MCP client with the consumer credentials so the server can sign requests:

# Claude Code
claude mcp add discogs -e DISCOGS_CONSUMER_KEY=your_key -e DISCOGS_CONSUMER_SECRET=your_secret -- npx -y discogs-mcp

Remote server (Cloudflare Worker)

Want to add Discogs as a custom connector in Claude instead of running it locally? The worker/ directory is a read-only remote MCP server (Streamable HTTP) you can deploy to Cloudflare Workers in a few clicks — no npx process on your machine. See worker/README.md for the one-time setup.

Environment variables

Security notes

• The access token/secret saved by login are only as sensitive as your Discogs account — they grant the same access you approved (collection, wantlist, marketplace, orders). The file is written with 0600 permissions.

• You can revoke access at any time from your Discogs account under Settings → Developers, then delete ~/.config/discogs-mcp/credentials.json locally.

• Tools that create, modify, or delete marketplace listings/orders are real, live actions — most MCP clients ask for confirmation before running a tool call, but treat those tools as if they were.

• See SECURITY.md for how to report a vulnerability.

Development

git clone https://github.com/Spiegelberg/discogs-mcp.git
cd discogs-mcp
npm install

npm run dev        # run the server against source with tsx
npm run lint
npm run typecheck
npm test
npm run build       # bundle to dist/

See CONTRIBUTING.md for more.

Publishing / distribution checklist

Automated by this repo:

• npm run build produces a working dist/index.js bin.

• CI (.github/workflows/ci.yml) lints, typechecks, tests, and builds on every push/PR.

• Pushing a vX.Y.Z tag runs .github/workflows/publish.yml, which publishes to npm with provenance.

• server.json is ready to submit to the open MCP Registry via the mcp-publisher CLI, and package.json's mcpName field matches it.

Still manual, and outside what code in this repo can do:

• Create/own the discogs-mcp npm package and add an NPM_TOKEN repo secret so the publish workflow can run.

• Run mcp-publisher (or open a PR against the MCP Registry) to list it there.

• If you want it in Anthropic's curated in-product connector directory, that's a separate outreach/review process with Anthropic — not something a GitHub Action can trigger.

License

MIT