Search the Discogs database. Combine free-text query with field filters.

    Use barcode or catno to pin down a specific pressing. `year` accepts a year or
    range like "1990-1995". Returns a compact list; fetch details with get_release /
    get_master / get_artist / get_label.
    

Full detail for one release (a specific pressing): tracklist, credits, labels and catalog numbers, formats, identifiers (barcodes, matrix/runout etchings), notes, community have/want and rating.

A master release: the umbrella over every version/pressing of an album.

List every version (pressing) of a master, with label, catno, country and year.

    Filter by format (e.g. "Vinyl"), country, year (`released`) or label. Use it for
    "which pressing is this?" then confirm with get_release identifiers.
    

Artist profile, real name, aliases, name variations, groups and members.

An artist's discography (masters and releases, including appearances with roles).

Label profile including parent label and sublabels.

Releases on a label, with catalog numbers.

The authenticated Discogs user: username, profile, collection/wantlist sizes.

A user's public lists (defaults to you).

Items in a Discogs list, with each item's comment.

Marketplace snapshot for a release: lowest listed price and number for sale.

    `currency` is an ISO code such as USD, EUR, GBP (defaults to your account currency).
    

Suggested sale price for each condition grade, based on Discogs sales history.

Discogs only returns this for accounts with seller settings filled in; otherwise it returns a 403 and this tool explains that.

Estimated collection value: minimum, median and maximum (based on sales history).

Collection folders with item counts. Folder 0 is "All", 1 is "Uncategorized".

One page of the collection straight from Discogs (folder 0 = all).

    For questions across the whole collection, prefer the cache tools
    (query_collection, collection_summary): they avoid paging through the API.
    

Every copy (instance) of a release in the collection, with folder, rating and fields. Returns an empty list if it is not owned.

Custom collection fields (e.g. Media Condition, Sleeve Condition, Notes) and their allowed options. Use the ids with set_collection_field.

Add a release to a collection folder (default 1 = Uncategorized; 0 is not allowed).

    Dry-run by default: returns a preview. Call again with dry_run=false to apply.
    

Remove one copy (instance) of a release from the collection. Destructive: needs dry_run=false AND confirm=true. Get instance ids from find_in_collection.

Move a collection instance to another folder. Dry-run by default.

Set a 0–5 star rating on a collection instance (0 clears it). Dry-run by default.

Set a custom field (e.g. Media Condition) on a collection instance. For dropdown fields the value must be one of the options from get_collection_fields. Dry-run by default.

Create a collection folder. Dry-run by default.

Rename a collection folder (not 0 or 1). Dry-run by default.

Delete an empty collection folder (not 0 or 1). Destructive: needs dry_run=false AND confirm=true. Discogs refuses to delete folders that still contain items.

One page of the wantlist. For whole-wantlist questions, sync_collection and then query the wants view with query_collection.

Add a release to the wantlist, or update notes/rating if it's already there.

    Dry-run by default: returns a preview. Call again with dry_run=false to apply.
    

Remove a release from the wantlist. Destructive: needs dry_run=false AND confirm=true.

Copy the collection, folders and wantlist into the local SQLite cache.

    Incremental (default) fetches only items added since the last sync. full=true
    re-reads everything and also catches removals, folder moves and edits. Run this
    before using query_collection or collection_summary. Tracklists and countries
    come from sync_release_details.
    

Fetch full release detail (tracklist, country) for cached releases that lack it.

    Costs one API request per release (Discogs allows 60/min), so by default it runs in
    the background and returns immediately; check progress with sync_status. It is
    resumable: re-running continues where it stopped. Leaves headroom in the rate limit
    for other tools.
    

Last sync times, cache counts and progress of any background detail fetch.

Run a read-only SQL SELECT against the local collection cache (max 500 rows). Use it to answer any question across the whole collection without API calls.

Tables and views (SQLite):

• collection (view): instance_id, folder_id, folder, rating, date_added, fields, release_id, master_id, artist, title, year, labels, catnos, format, formats, genres, styles, country

• wants (view): release_id, rating, notes, date_added, master_id, artist, title, year, labels, catnos, format, formats, genres, styles, country

• releases: id, master_id, artist, title, year, labels, catnos, format, formats, genres, styles, country, details_fetched_at

• release_labels: release_id, label_id, name, catno (one row per label on a release)

• collection_items: instance_id, release_id, folder_id, rating, date_added, fields

• item_fields: instance_id, field_id, name, value (e.g. name='Media Condition')

• folders: id, name, count

• tracks: release_id, position, title, artists, duration, seq (needs sync_release_details)

• sync_meta: key, value labels, catnos, genres and styles are JSON arrays: use json_each, e.g. SELECT s.value AS style, COUNT(*) FROM collection, json_each(collection.styles) s GROUP BY 1 fields is a JSON object: json_extract(fields, '$."Media Condition"'). country and tracks are only populated after sync_release_details.

Collection overview from the cache: counts by genre, style, label, artist, decade, format and country, duplicate masters (same album owned more than once), and the last sync time.

Write the cached collection to a CSV or JSON file (default ~/.discogs-mcp/collection.).