Discogs MCP Server

Search and manage your Discogs music catalog, collection, wantlist, and marketplace from your AI client.

Unverified

stdio (local)

API key

TypeScript

View repo 112 npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y discogs-mcp-server

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js (tested with 20.x.x; 18.x.x should also work)
A Discogs personal access token (from Discogs Settings > Developers)
Docker (optional, for running via the prebuilt image)

About Discogs MCP Server

Discogs MCP Server connects an MCP client (such as Claude Desktop, LibreChat, or LM Studio) to the Discogs API. It lets you search the Discogs database, inspect releases/masters/artists/labels, manage your collection and wantlist, view and edit marketplace listings and orders, and request inventory exports. It is built on the FastMCP TypeScript framework and is distributed as the npm package discogs-mcp-server, runnable via NPX, local Node, or Docker.

Tools & capabilities (54)

get_user_identity

Retrieve basic information about the authenticated user.

get_user_profile

Retrieve a user by username.

edit_user_profile

Edit a user's profile data (name, profile text, location, homepage, currency).

get_user_submissions

Retrieve a user's submissions (artists, labels, releases) by username.

get_user_contributions

Retrieve a user's contributions by username, with paging and sorting.

get_user_collection_folders

Retrieve a list of folders in a user's collection.

create_user_collection_folder

Create a new folder in a user's collection.

get_user_collection_folder

Retrieve metadata about a folder in a user's collection.

edit_user_collection_folder

Edit (rename) a folder in a user's collection.

delete_user_collection_folder

Delete an empty folder from a user's collection.

get_user_collection_items

Retrieve a list of items in a user's collection folder.

add_release_to_user_collection_folder

Add a release to a folder in a user's collection.

delete_release_from_user_collection_folder

Remove a release instance from a user's collection folder.

find_release_in_user_collection

Find a release in a user's collection.

rate_release_in_user_collection

Rate a release (1-5) in a user's collection.

move_release_in_user_collection

Move a release in a user's collection to another folder.

get_user_collection_custom_fields

Retrieve a list of user-defined collection notes fields.

edit_user_collection_custom_field_value

Edit a custom field value for a release in a user's collection.

get_user_collection_value

Return the minimum, median, and maximum value of a user's collection.

get_release

Get a release by ID (optionally with a currency code).

get_release_rating

Get a release's rating for a given user.

edit_release_rating

Update a release's rating (1-5) for a given user.

delete_release_rating

Delete a release's rating for a given user.

get_release_community_rating

Get a release's community rating average and count.

get_master_release

Get a master release by ID.

get_master_release_versions

Retrieve all releases that are versions of a master, with paging, sorting, and filters.

get_artist

Get an artist by ID.

get_artist_releases

Get an artist's releases, with paging and sorting.

get_label

Get a label by ID.

get_label_releases

Get releases associated with a label, with paging and sorting.

search

Search the Discogs database by query, type, title, artist, label, genre, style, country, year, format, barcode, and more.

get_release_rating_by_user

Retrieve a release's rating for a given user.

get_user_inventory

Return the list of listings in a user's inventory, with status filtering, paging, and sorting.

get_marketplace_listing

Get a marketplace listing by ID (optionally with a currency code).

create_marketplace_listing

Create a new marketplace listing (release, condition, price, status, and more).

update_marketplace_listing

Update an existing marketplace listing.

delete_marketplace_listing

Delete a marketplace listing.

get_marketplace_order

Get a marketplace order by ID.

edit_marketplace_order

Edit a marketplace order's status or shipping cost.

get_marketplace_orders

Get a list of marketplace orders, with status/date filters, paging, and sorting.

get_marketplace_order_messages

Get a list of an order's messages.

create_marketplace_order_message

Add a new message to an order's message log (optionally updating status).

get_marketplace_release_stats

Retrieve marketplace statistics (lowest price, number for sale, blocked status) for a release.

get_user_lists

Get a user's lists.

get_list

Get a list by ID.

get_user_wantlist

Return the list of releases in a user's wantlist, with paging and sorting.

add_to_wantlist

Add a release to a user's wantlist (with optional notes and rating).

edit_item_in_wantlist

Edit a release in a user's wantlist (notes and rating).

delete_item_in_wantlist

Delete a release from a user's wantlist.

fetch_image

Fetch an image by URL.

inventory_export

Request an export of your inventory as a CSV.

get_inventory_exports

Get a list of all recent inventory exports.

get_inventory_export

Get details about a specific inventory export.

download_inventory_export

Download an inventory export as a CSV string.

What this server can do

Discogs MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Search the web

When to use it

Search the Discogs database for releases, artists, labels, and masters from your AI assistant
Browse and organize your record collection — folders, ratings, custom fields, and collection value
Manage your wantlist by adding, editing, and removing releases
View and manage Discogs marketplace listings and orders, including order messages
Request and download CSV exports of your seller inventory

Security notes

Requires a Discogs personal access token (set via the DISCOGS_PERSONAL_ACCESS_TOKEN environment variable) — do not share your token. The server can edit data in your Discogs collection (add/remove/move releases, ratings, marketplace listings and orders, wantlist), so verify actions before executing them. OAuth is not yet supported.

Discogs MCP Server FAQ

How do I authenticate?

Set the DISCOGS_PERSONAL_ACCESS_TOKEN environment variable to your Discogs personal access token, obtained from Discogs Settings > Developers. OAuth support is planned for a future release.

What is the fastest way to get started?

Install Node.js, get your Discogs personal access token, and use the NPX configuration in your MCP client (e.g. Claude Desktop) — `npx -y discogs-mcp-server` with the token set in env.

Can it modify my Discogs data?

Yes. The server can edit your collection, ratings, wantlist, marketplace listings, and orders. Verify actions before executing them.

Why do responses default to only a few items?

The Discogs API per_page default of 50 is overridden to a project default of 5 (discogs.config.defaultPerPage) so smaller clients can process responses. You can request more in your prompts.

Which MCP clients are documented?

The README provides configuration for Claude Desktop (via NPX, local Node, or Docker), LibreChat, and LM Studio.

#discogs #music #catalog #marketplace #collection #vinyl #fastmcp #typescript

Alternatives to Discogs MCP Server

Compare all alternatives →

Fetch (Reference)

Search & Web

87k

Official MCP reference server that fetches a URL and returns its content as clean Markdown, with chunking.

Verified

stdio (local)

No auth

Python

2 tools

Updated 12 days agoRepo

Firecrawl

Search & Web

6.6k

Official Firecrawl MCP server — scrape, crawl, map, search, and structured extraction for any LLM client.

Verified

stdio (local)

API key

TypeScript

8 tools

Updated 10 days agoRepo

Exa Search

Search & Web

4.6k

Exa's neural web search and crawling MCP server — runs locally via npx or as a hosted remote endpoint.

Verified

stdio (local)

API key

TypeScript

6 tools

Updated 11 days agoRepo

Compare Discogs MCP Server with:

vs Fetch (Reference)vs Firecrawl vs Exa Search vs Perplexity