Cratedigger
Integrates with the Discogs API to retrieve release and pressing details, including label, catalog number, format, country, year, tracklist, have/want counts, master release information, identifiers such as matrix/runout and barcode, and release notes. The README also describes intended coverage of Marketplace prices and the user's Collection and Wantlist, though only the release-detail tool is currently available.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cratedigger Show me Discogs release 249504 in detail, including matrix and barcode."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cratedigger for Discogs
cratedigger-mcp is a small local MCP server that lets Claude
answer everyday questions about your Discogs world: Releases and pressings in the catalog,
Marketplace prices, and your own Collection and Wantlist.
It runs on your machine over stdio, talks to the Discogs API with your personal access token and stores nothing on disk.
Status: early development. Available tools so far:
discogs_search: search the catalog for Releases (default), Masters, artists or labels by free text, narrowed by artist, year, Format, country, catalog number or barcode. Results are paged and carry therelease_id/master_idfor the next call.
discogs_get_release: the card of one Release byrelease_id: label, catalog number, Format, country, year, tracklist, have/want counts and Master. Its detailed form adds identifiers (matrix/runout, barcode) and release notes.
discogs_list_master_releases: the Releases of a Master bymaster_id, to compare the editions of an album by country, year, label, catalog number and Format. It filters by Format, country and year, sorts by release date by default and pages, and every line carries therelease_id.
discogs_get_prices: the Lowest price (the cheapest current listing in any condition, excluding shipping), the number of copies for sale and the blocked-from-sale flag of 1 to 10 Releases, with the time each was checked. Prices are kept in memory for an hour.
discogs_list_collection: the Copies in your Collection, newest first by default, filtered by artist or title text, narrowed to one folder, sorted and paged. Each line carries the Release, its Format, its condition (Media and Sleeve grades) and therelease_id, and marks Releases you have several Copies of.
discogs_list_wantlist: the Wants on your Wantlist, newest first, filtered by artist or title text and paged. Each line carries the Release, its Format and therelease_id.
discogs_wantlist_prices: the Lowest price of up to 30 Wants per call (a page of your Wantlist, newest first), sorted from cheapest, optionally only those at or undermax_priceand filtered by artist or title text. Wants with nothing for sale are listed apart, and the response says which page to check next. It shares the one-hour price cache withdiscogs_get_prices. There is no price watch: Discogs' own Wantlister sends alerts.
discogs_wantlist_add: adds a Release to your Wantlist byrelease_idand returns a short card of it. Adding a Release that is already wanted succeeds and changes nothing.
discogs_wantlist_remove: removes a Want byrelease_id. It is marked destructive and asks for your confirmation on every call; a Release that is not on the Wantlist is an error. Both Wantlist tools drop the cached Wantlist, so the next listing is fetched afresh; Discogs' own listing can take about 10 seconds to show the change. No tool changes your Collection.
discogs_collection_summary: the number of Copies in each folder and Discogs' minimum/median/maximum estimate of the Collection's value.
discogs_match_collection: checks 1 to 200 artist/album pairs from any other source (Last.fm, Spotify, a pasted list) against your Collection and Wantlist. Each album is in Collection (any Release of its Master, in any Format, with the matching Copies listed), on Wantlist, possible (a longer or shorter title of the same artist under another Master, such as a reissue with an added subtitle or a live album; titles that differ only by a series number such as "III" or "Vol. 2" count as different albums) or absent. Names match ignoring case, diacritics, punctuation, a leading "The", "&" versus "and" and edition qualifiers such as "(Remastered)". It reads only your Collection and Wantlist and never searches the catalog per album.The server finds your username from the token. It keeps the Collection and the Wantlist in memory and checks their first page on every call, so a Want or Copy you add on Discogs shows at once while a follow-up question costs one or two Discogs requests.
And one prompt:
identify_release: guides Claude through finding the exact Release you hold from its barcode, catalog number and matrix/runout etchings.
Requirements
uv (provides
uvx)A Discogs personal access token: open Discogs → Settings → Developers and click Generate new token. The server refuses to start without it.
Related MCP server: Discogs MCP Server
Connect to Claude
The package is not on PyPI yet. Until it is, run it from a local checkout with
uvx --from /absolute/path/to/cratedigger-mcp cratedigger-mcp. After the first release this
becomes plain uvx cratedigger-mcp.
Claude Desktop
Claude Desktop on macOS does not see your shell PATH, so give it the absolute path to
uvx (find it with which uvx). Add this to
~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop:
{
"mcpServers": {
"cratedigger": {
"command": "/absolute/path/to/uvx",
"args": ["--from", "/absolute/path/to/cratedigger-mcp", "cratedigger-mcp"],
"env": { "DISCOGS_TOKEN": "your-personal-access-token" }
}
}
}Claude Code
claude mcp add cratedigger --env DISCOGS_TOKEN=your-personal-access-token \
-- uvx --from /absolute/path/to/cratedigger-mcp cratedigger-mcpThen ask, for example: "Show me Discogs release 249504 in detail."
Settings
Environment variable | Required | Meaning |
| yes | Your Discogs personal access token |
| no | Currency of prices: USD, GBP, EUR (default), CAD, AUD, JPY, CHF, MXN, BRL, NZD, SEK or ZAR. A tool call can still ask for another one. |
Development
Requires uv 0.13.x and just.
uv sync # create .venv from uv.lock
just check # ruff, mypy and pytest: the same command CI runs on Python 3.12–3.15
just fix # apply ruff fixes and formatting
just serve # run the server over stdio (needs DISCOGS_TOKEN)Tests build the server through create_server() and call its tools through FastMCP's in-memory
client against a fake Discogs (httpx2.MockTransport) serving anonymized fixtures. No test touches
the network.
Discogs
Every response that contains Discogs data ends with "Data provided by Discogs" and a link to the data on discogs.com.
This application uses Discogs' API but is not affiliated with, sponsored or endorsed by Discogs. "Discogs" is a trademark of Zink Media, LLC.
License
MIT
Available Tools
11 toolsdiscogs_collection_summarySummarize My Discogs CollectionARead-only
Summarize the Owner's own Discogs Collection: its size and what it is worth.
Shows the number of Copies in the Collection and in each of its folders, with the folder_id for discogs_list_collection, and Discogs' minimum, median and maximum estimate of the Collection's value, as Discogs reports it in the currency of the Owner's Discogs settings. Use discogs_list_collection to see the Copies themselves and discogs_get_prices for the Lowest price of particular Releases.
Inputs: no named parameters.
discogs_get_pricesGet Discogs Marketplace PricesARead-only
Show what Releases (pressings) cost on the Discogs Marketplace right now.
For each of 1 to 10 release_ids: the Lowest price, how many copies are for sale and whether the Release is blocked from sale, with the time Discogs reported it. The Lowest price is the cheapest current listing in any condition, excluding shipping: not a market value. Use it to compare editions by price, for example after discogs_list_master_releases. For the prices of the Owner's Wantlist use discogs_wantlist_prices.
Inputs: release_ids (required), currency.
discogs_get_releaseGet Discogs ReleaseARead-only
Show the card of one Discogs Release (a specific pressing or edition) by its release_id.
Use it when the release_id is known, for example from discogs_search results, to see what exactly a pressing is: label, catalog number, Format, country, year, tracklist, how many Discogs users have or want it, and its Master. Ask for the detailed form to tell near-identical pressings apart by matrix/runout etchings, barcode and notes. Do not use it to find a Release by name (use discogs_search) or for prices (use discogs_get_prices).
Inputs: release_id (required), response_format.
discogs_list_collectionList My Discogs CollectionARead-only
List the Copies in the Owner's own Discogs Collection: vinyl, CDs, any Format.
Use it for "what do I have", "do I have anything by X", "what did I add recently" or to browse one Collection folder. Newest first unless another sort is asked for, and paged. Each line carries the Release, its Format, the folder, the condition (Media and Sleeve grades) and the release_id, and marks Releases the Owner has several Copies of. The query matches artist and title text only. Do not use it to find Releases the Owner lacks (use discogs_search), and use discogs_match_collection to check a list of albums from another source.
Inputs: page, sort, limit, query, +1 more.
discogs_list_master_releasesList Releases of a Discogs MasterARead-only
List the Releases of a Discogs Master: all pressings, versions and editions of an album.
Use it to compare the available editions of an album by country, year, label, catalog number and Format, narrowed to one Format, country or year. Each line carries the release_id for discogs_get_release. Results are sorted by release date unless another sort is asked for, and paged. Find the master_id with discogs_search (type="master") or on a Release card.
Inputs: master_id (required), page, sort, year, +3 more.
discogs_list_wantlistList My Discogs WantlistARead-only
List the Wants on the Owner's own Discogs Wantlist: the Releases they want to get.
Use it for "what is on my Wantlist", "do I want anything by X" or "what did I add to my Wantlist recently". Newest first and paged. Each line carries the Release, its Format, label and catalog number, when it was added and the release_id. The query matches artist and title text only: the lines carry no genres or styles, so a query such as "jazz" finds only artists and titles containing the word. Do not use it to find Releases in the catalog (use discogs_search) or to see what the Owner already has (use discogs_list_collection), and use discogs_wantlist_prices for what the Wants cost.
Inputs: page, limit, query.
discogs_match_collectionMatch Albums Against My Discogs CollectionARead-only
Check a list of albums from another source against the Owner's Collection and Wantlist.
Use it for "which of these albums do I have": albums from Last.fm or Spotify listening history, a playlist or a pasted list, up to 200 per call. One line per album: in Collection (with the Release and Format of each matching Copy, so vinyl tells apart from CD), on Wantlist, possible (naming the candidate) or absent. An album is in the Collection when the Owner has any Release of its Master, in any Format; Releases without a Master match on artist and title. Names match ignoring case, diacritics, punctuation, a leading "The", "&" versus "and" and edition qualifiers such as Remastered, Deluxe, Expanded, Anniversary or Mono. A possible match is a Release of the same artist whose title contains the album's title or is contained in it, under another Master; titles that differ only by a series number (III, Vol. 2) are two albums. It reads only the Owner's Collection and Wantlist, never the catalog: do not call discogs_search album by album, and use discogs_list_collection to browse.
Inputs: albums (required).
discogs_searchSearch Discogs CatalogARead-only
Search the Discogs catalog for Releases (pressings), Masters, artists or labels.
Use it to find a release_id or master_id by name, or to find the exact pressing the Owner is holding by narrowing with artist, year, Format, country, catalog number or barcode. Each result carries the release_id/master_id for discogs_get_release and the other tools. Results are paged: the response states the page and the total. Do not use it to check what the Owner has or wants: use discogs_list_collection or discogs_list_wantlist, and discogs_match_collection for a list of albums.
Inputs: page, type, year, catno, +6 more.
discogs_wantlist_addAdd to My Discogs WantlistAIdempotent
Add a Release (one specific pressing) to the Owner's own Discogs Wantlist as a Want.
Use it when the Owner asks to want, save or track a Release found with discogs_search, discogs_get_release or discogs_list_master_releases. Adding a Release that is already on the Wantlist succeeds and changes nothing. Returns a short card of the Release. It never changes the Collection. Discogs' own Wantlist listing can take about 10 seconds to show the new Want. Do not use it to find a Release by name (use discogs_search) or to add a Master: pick one of its Releases first.
Inputs: release_id (required).
discogs_wantlist_pricesGet Prices of My Discogs WantlistARead-only
Check what the Wants on the Owner's own Discogs Wantlist cost on the Marketplace now.
Use it for "what on my Wantlist is cheap right now" or "which Wants are under 30 EUR". It checks the Lowest price of at most 30 Wants per call (a page of the Wantlist, newest first), keeps those at or under max_price, sorts them from cheapest and lists the Wants with nothing for sale apart. When more Wants remain, the response says which page to check next. The Lowest price is the cheapest current listing in any condition, excluding shipping: not a market value. There is no price watch: Discogs' own Wantlister sends alerts. Use discogs_get_prices for particular Releases and discogs_list_wantlist to list the Wantlist without prices.
Inputs: page, limit, query, currency, +1 more.
discogs_wantlist_removeRemove from My Discogs WantlistADestructive
Remove a Want from the Owner's own Discogs Wantlist, by the release_id of its Release.
Use it only when the Owner asks to remove, drop or delete a Want, and confirm the Release with them first: the Want's date added is lost. Find the release_id with discogs_list_wantlist. A Release that is not on the Wantlist is an error. It never changes the Collection. Discogs' own Wantlist listing can take about 10 seconds to show the change. Do not use it to tidy up the Wantlist on your own, or because a Want is now in the Collection, unless the Owner asks.
Inputs: release_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct target: catalog search, release card, master pressings, marketplace prices, collection listing, wantlist listing, wantlist mutation, cross-source matching, and collection summary. Descriptions go further than most servers by naming the sibling tool to use instead ('Do not use it to find a Release by name (use discogs_search)', 'use discogs_wantlist_prices for what the Wants cost'), which removes the near-misses between get_prices / wantlist_prices and list_collection / match_collection / collection_summary.
All tools are snake_case with a uniform discogs_ prefix and mostly verb_noun order (get_release, list_collection, match_collection). A few deviate into noun-first compounds (discogs_wantlist_prices, discogs_wantlist_add, discogs_collection_summary) and get_prices sits alongside wantlist_prices, so the pattern is readable but not perfectly uniform.
Eleven tools is squarely in the well-scoped range, and each one covers a distinct read or write surface (search, release, master, prices, collection, wantlist x3, match, summary). Nothing looks like a redundant variant of another tool.
The read side is thorough, and the Wantlist has full add/remove lifecycle support, but the Collection is read-only: there is no way to add a Release to the collection, remove a copy, or edit folder/condition/rating, which is an asymmetric gap given wantlist_add/wantlist_remove exist. An agent asked to 'add this to my collection' hits a dead end.
Maintenance
Related MCP Connectors
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Ask Claude about Phish shows: setlists, song gaps, jams, venues. Live from Phish.net.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseBqualityDmaintenanceA server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.5615MIT
- AlicenseNot gradedqualityBmaintenanceSearch, rate and organise your Discogs collection, wantlist and folders from an AI assistant. Self-hosted: deploy your own copy to Cloudflare Workers with the Deploy to Cloudflare button in the README. Not affiliated with Discogs.20MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI assistants to interact with a personal Discogs music collection, supporting search, collection management, wantlist, folders, custom fields, and recommendations via Cloudflare Workers.MIT
- AlicenseBqualityCmaintenanceGives Claude full access to Discogs for database lookups, collection and wantlist management (with dry-run write safety), and marketplace pricing. It also syncs everything into a local SQLite cache for read-only SQL analysis and optional matching against a digital music library.35MIT