Skip to main content
Glama

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 the release_id/master_id for the next call.

  • discogs_get_release: the card of one Release by release_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 by master_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 the release_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 the release_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 the release_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 under max_price and 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 with discogs_get_prices. There is no price watch: Discogs' own Wantlister sends alerts.

  • discogs_wantlist_add: adds a Release to your Wantlist by release_id and returns a short card of it. Adding a Release that is already wanted succeeds and changes nothing.

  • discogs_wantlist_remove: removes a Want by release_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

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-mcp

Then ask, for example: "Show me Discogs release 249504 in detail."

Settings

Environment variable

Required

Meaning

DISCOGS_TOKEN

yes

Your Discogs personal access token

DISCOGS_CURRENCY

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 tools
discogs_collection_summarySummarize My Discogs CollectionA
Read-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 PricesA
Read-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 ReleaseA
Read-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 CollectionA
Read-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 MasterA
Read-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 WantlistA
Read-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 CollectionA
Read-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_wantlist_addAdd to My Discogs WantlistA
Idempotent

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 WantlistA
Read-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 WantlistA
Destructive

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

    A4.4/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      5
      615
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Search, 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.
      20
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP 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
    • A
      license
      B
      quality
      C
      maintenance
      Gives 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.
      35
      MIT