Discogs

v0.5.6Search & Data Extractionstable

Enables interactions with the Discogs API for music catalog operations and search functionality, allowing users to manage their Discogs collections through natural language.

DiscogsMCP
Share:
99
Stars
0
Downloads
0
Weekly
0/5

What is Discogs?

Discogs is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interactions with the discogs api for music catalog operations and search functionality, allowing users to manage their discogs collections through natural language.

Enables interactions with the Discogs API for music catalog operations and search functionality, allowing users to manage their Discogs collections through natural language.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interactions with the Discogs API for music catalog

Use Cases

Search music catalog and collection data
Manage music collection records
cswkim

Maintainer

LicenseMIT License
Languagetypescript
Versionv0.5.6
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y discogs-mcp-server

Manual Installation

npx -y discogs-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Discogs

The Discogs MCP Server connects AI assistants to the Discogs music database and marketplace through a comprehensive set of tools covering user collections, wantlists, the full Discogs catalog, marketplace listings, and orders. It exposes over 50 tools including searching releases and artists, managing collection folders, rating releases, adding items to wantlists, creating and updating marketplace listings, and retrieving order history. Music collectors and sellers use it to manage their vinyl and music collections, research market values, and automate catalog operations through natural language commands.

Prerequisites

  • Node.js 18 or higher installed
  • A Discogs account at https://www.discogs.com
  • A Discogs Personal Access Token from Settings > Developers > Generate Token
  • An MCP-compatible client such as Claude Desktop
1

Obtain a Discogs Personal Access Token

Log in to Discogs, navigate to Settings > Developers, and click 'Generate new token'. Copy the token — you will need it in your MCP config. Keep it secret as it grants full access to your Discogs account.

2

Add the server to your MCP client configuration

Open your claude_desktop_config.json and add the Discogs server entry with your token in the DISCOGS_PERSONAL_ACCESS_TOKEN environment variable.

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": ["-y", "discogs-mcp-server"],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}
3

Restart your MCP client

Restart Claude Desktop to load the Discogs server. The tools will be available immediately once the server connects.

4

Verify connection by fetching your user identity

Ask your AI assistant to confirm who you are logged in as on Discogs. This confirms the token is valid and the server is connected.

5

Optional: run with Docker

For a more isolated setup, run the server as a Docker container. Build the image once and pass your token as an environment variable.

docker build -t discogs-mcp-server:latest https://github.com/cswkim/discogs-mcp-server.git
docker run -e DISCOGS_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN discogs-mcp-server:latest

Discogs Examples

Client configuration

Add this to your claude_desktop_config.json. Replace YOUR_TOKEN_HERE with your actual Discogs Personal Access Token.

{
  "mcpServers": {
    "discogs": {
      "command": "npx",
      "args": ["-y", "discogs-mcp-server"],
      "env": {
        "DISCOGS_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Prompts to try

Use these prompts to interact with your Discogs collection, the music database, and the marketplace.

- "Show me all the releases in my Discogs collection."
- "Search the Discogs database for albums by Boards of Canada."
- "What is the community rating for the album 'In Rainbows' by Radiohead?"
- "Add the release with ID 249504 to my wantlist."
- "What is the current minimum, median, and maximum value of my entire collection?"
- "List all my current marketplace listings and their prices."
- "Show me all versions of the master release for Pink Floyd's 'The Dark Side of the Moon'."

Troubleshooting Discogs

All API calls return 401 Unauthorized

Your DISCOGS_PERSONAL_ACCESS_TOKEN is missing, expired, or incorrect. Return to Discogs Settings > Developers, generate a new token, and update it in your claude_desktop_config.json.

Search results are limited to only 5 items

This is by design — the server defaults to 5 results per page (Discogs API default is 50). Ask the AI to request a specific page or more results explicitly in your prompt, e.g. 'search for X and show me 20 results'.

Write operations like add_release_to_user_collection_folder fail

Confirm your Discogs token has write permissions. Tokens generated from Settings > Developers have full access by default. Also verify the folder ID exists in your collection before trying to add items to it.

Frequently Asked Questions about Discogs

What is Discogs?

Discogs is a Model Context Protocol (MCP) server that enables interactions with the discogs api for music catalog operations and search functionality, allowing users to manage their discogs collections through natural language. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Discogs?

Install via npm with the command: npx -y discogs-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Discogs?

Discogs works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Discogs free to use?

Yes, Discogs is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Discogs?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides