Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DISCOGS_TOKENYesYour Discogs personal access token. The server refuses to start without it.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Cratedigger for Discogs: the Owner's window onto Discogs, the vinyl and music database and Marketplace. Use these tools for the Discogs catalog (Masters, Releases and pressings: label, catalog number, Format, country, year, matrix/runout and barcode identifiers), Marketplace prices of Releases, and the Owner's own Collection and Wantlist on Discogs. Every response carries the release_id or master_id needed for the next call. To check a list of albums from another source (listening history, playlists) against the Owner's shelf, use discogs_match_collection rather than searching album by album. The Collection is read-only. Wants are added with discogs_wantlist_add and removed, only when the Owner asks, with discogs_wantlist_remove.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
discogs_get_releaseA

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).

discogs_searchA

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.

discogs_list_master_releasesA

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.

discogs_get_pricesA

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.

discogs_list_collectionA

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.

discogs_list_wantlistA

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.

discogs_wantlist_pricesA

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.

discogs_wantlist_addA

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.

discogs_wantlist_removeA

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.

discogs_match_collectionA

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.

discogs_collection_summaryA

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.

Prompts

Interactive templates invoked by user choice

NameDescription
identify_releaseFind out which Discogs Release (pressing) the Owner is holding.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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