Tools / Record Collector

Search Releases

Search release catalogs for likely matching vinyl, CD, cassette, and box-set editions using artist, title, label, barcode, catalog number, country, and year clues.

Returns: Likely matching releases with edition clues, collector demand, and current market stats where available

Parameters

querystringFree-text release query such as "Nirvana Nevermind" or "Blue Note 1527"

artiststringArtist or band name to match

titlestringRelease title or album title to match

formatstringPreferred format such as lp, 7inch, cd, cassette, or box_set

countrystringOptional country or market code such as US, UK, JP, DE, FR, or CA

yearnumberOptional release year to bias edition matching

labelstringOptional label name to narrow results

barcodestringOptional barcode or UPC when you want a more exact edition match

catalog_numberstringOptional catalog number or matrix clue such as "DGCD-24425"

sourcestringCatalog source to search: all, discogs, or musicbrainz

sourcesarrayOptional explicit catalog source list when you want to search multiple named sources

limitnumberMaximum releases to return (1-20, default 10)

pagenumberPage number for search pagination (default 1)

Example

Search for Nevermind releases by Nirvana on vinyl

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "search_releases",
  "input": {
    "artist": "Nirvana",
    "title": "Nevermind",
    "format": "lp",
    "limit": 8
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Release Details

Get a detailed release profile including tracklist, identifiers, labels, formats, notes, artwork, and current market stats. Use a Discogs or MusicBrainz release id, or resolve from a query.

Returns: Full release profile with tracklist, identifiers, artwork, label and format details, and current market pricing

Parameters

discogs_release_idnumberDiscogs release id from search_releases or identify_pressing results

discogs_master_idnumberOptional Discogs master id when you want the master profile plus version list

musicbrainz_release_idstringMusicBrainz release id (UUID) when you want MusicBrainz metadata

querystringFallback query to resolve the best Discogs release automatically

Example

Get full details for a Discogs release by id

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "release_details",
  "input": {
    "discogs_release_id": 7097051
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Identify Pressing

Identify a specific vinyl pressing from catalog number, barcode, matrix/runout inscription, or partial info. Essential for distinguishing original pressings from reissues. Searches Discogs identifiers and cross-references matrix numbers.

Returns: Ranked pressing candidates with edition details, identifiers, and matrix match flags

Parameters

catnostringCatalog number printed on the label or spine (e.g. "BLP 1501", "FACT 10", "PCS 7027")

barcodestringBarcode or UPC from the packaging

matrixstringMatrix/runout inscription etched in the dead wax near the label (e.g. "YEX-749-1")

querystringGeneral search if no specific identifiers (e.g. "Led Zeppelin I UK first pressing")

artiststringArtist name to narrow results

titlestringAlbum or single title to narrow results

countrystringCountry of pressing (e.g. "US", "UK", "Japan")

yearstringYear or year range (e.g. "1969", "1965-1970")

formatstringFormat hint (e.g. "vinyl", "lp", "7"")

Example

Identify by catalog number

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "identify_pressing",
  "input": {
    "catno": "BLP 1501"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Edition Match

Score likely pressings and reissues from partial clues like barcode, catalog number, country, format, year, and label so you can identify the closest edition match.

Returns: Ranked edition candidates with matched clue fields and current market context

Parameters

querystringFree-text release query such as "Nirvana Nevermind" or "Blue Note 1527"

artiststringArtist or band name to match

titlestringRelease title or album title to match

formatstringPreferred format such as lp, 7inch, cd, cassette, or box_set

countrystringOptional country or market code such as US, UK, JP, DE, FR, or CA

yearnumberOptional release year to bias edition matching

labelstringOptional label name to narrow results

barcodestringOptional barcode or UPC when you want a more exact edition match

catalog_numberstringOptional catalog number or matrix clue such as "DGCD-24425"

sourcestringCatalog source to search: all, discogs, or musicbrainz

sourcesarrayOptional explicit catalog source list when you want to search multiple named sources

limitnumberMaximum releases to return (1-20, default 10)

pagenumberPage number for search pagination (default 1)

Example

Match a Nevermind pressing using country, year, and catalog number clues

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "edition_match",
  "input": {
    "artist": "Nirvana",
    "title": "Nevermind",
    "country": "CA",
    "year": 1991,
    "catalog_number": "DGCD-24425",
    "limit": 6
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Price Guide

Get current market pricing for a release — lowest listed price, number of copies for sale, community demand stats (want/have ratio), and condition-based pricing from Mint through Poor when a personal access token is configured.

Returns: Market snapshot with lowest price, supply depth, demand ratio, and condition-based pricing where available

Parameters

discogs_release_id *numberDiscogs release id from search_releases, identify_pressing, or edition_match results

currencystringCurrency code for prices (default "USD"). Supported: USD, GBP, EUR, CAD, AUD, JPY, CHF, MXN, BRL, NZD, SEK, ZAR

Example

Get price guide for a release

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "price_guide",
  "input": {
    "discogs_release_id": 249504
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Discogs Marketplace

Find active for-sale listings on the Discogs marketplace for a specific release. Shows number of copies available, lowest price, and a direct marketplace browse link.

Returns: Discogs marketplace overview with number of copies for sale, lowest price, and direct browse link

Parameters

release_idnumberDiscogs release ID from search_releases or identify_pressing results

querystringSearch query (alternative to release_id) — will find the best matching release

currencystringCurrency code for prices (default "USD"). Supported: USD, GBP, EUR, CAD, AUD, JPY, CHF, MXN, BRL, NZD, SEK, ZAR

Example

Find Discogs listings for a release

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "marketplace_listings",
  "input": {
    "release_id": 249504
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Global Market Search

Search 20+ global resale and retail platforms for music releases — including Discogs, eBay, Bandcamp, Mercari, Yahoo Auctions Japan, Rakuten, Facebook Marketplace, Craigslist, and more. Use this to find deals, compare prices across regions, or discover copies not listed on Discogs.

Returns: Sale listings and release pages from global record marketplaces with prices, regions, and caveats

Parameters

querystringFree-text release query such as "Nirvana Nevermind" or "Blue Note 1527"

artiststringArtist or band name to match

titlestringRelease title or album title to match

formatstringPreferred format such as lp, 7inch, cd, cassette, or box_set

conditionstringOptional condition hint such as used, new, sealed, or preowned

sourcestringSpecific market source: all, discogs, ebay, bandcamp, mercari, rakuma, yahoo_auctions_japan, cdandlp, musicstack, craigslist, and more.

sourcesarrayOptional explicit market source list when you want to search multiple named sources

regionsarrayOptional region filters such as GLOBAL, US, UK, EU, JP, LATAM, APAC, NZ, AU, SG, or HK

countrystringOptional 2-letter country code for search localization such as us, gb, jp, de, or au

languagestringOptional search language code such as en, ja, de, fr, or es

locationstringOptional local place name to bias classifieds-style queries

local_pickupbooleanBias the search toward listings mentioning local pickup or collection

limitnumberMaximum listings to return (1-25, default 10)

pagenumberPage number for search pagination (default 1)

Example

Search global resale markets for a used vinyl copy of Nevermind

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "market_search",
  "input": {
    "artist": "Nirvana",
    "title": "Nevermind",
    "format": "lp",
    "condition": "used",
    "regions": [
      "GLOBAL"
    ],
    "limit": 8
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Artist Discography

Browse an artist's full discography — albums, singles, compilations, and appearances. Shows release years, formats, labels, and community want/have stats. Requires an artist_id from search_releases.

Returns: Full artist discography with album details, formats, labels, roles, and community want/have statistics

Parameters

artist_id *numberDiscogs artist ID — obtain from search_releases with a query like the artist name, look for the id field in results with type "artist"

sort_bystringSort releases by

sort_orderstringSort direction

limitnumberResults per page (1-100, default 25)

pagenumberPage number (default 1)

Example

Browse Radiohead discography

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "artist_discography",
  "input": {
    "artist_id": 3840
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Label Catalog

Browse a record label's full release catalog. Accepts a label name (searches for the label automatically) or a Discogs label_id. Shows catalog numbers, artists, formats, and community demand.

Returns: Full label catalog with catalog numbers, artists, release years, formats, and community demand stats

Parameters

label_idnumberDiscogs label ID — optional, use query instead if you only have the label name

querystringLabel name to search for (e.g. "Blue Note", "Sub Pop", "Factory Records")

sort_bystringSort releases by

sort_orderstringSort direction

limitnumberResults per page (1-100, default 25)

pagenumberPage number (default 1)

Example

Browse Blue Note Records catalog

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "label_catalog",
  "input": {
    "query": "Blue Note"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Collection Value

Estimate the current value of a record collection from known release ids or item queries, with totals grouped by currency and line-level valuation details.

Returns: Per-item values plus grouped currency totals based on the current public market snapshot

Parameters

items *arrayCollection rows to value. Each item can provide a discogs_release_id or a query plus an optional quantity.

Example

Estimate the value of two known Discogs releases

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "record-collector",
  "skill": "collection_value",
  "input": {
    "items": [
      {
        "discogs_release_id": 7097051,
        "quantity": 1
      },
      {
        "discogs_release_id": 249504,
        "quantity": 2
      }
    ]
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"record-collector","skill":"search_releases","input":{}}' \
  https://api.toolrouter.com/v1/tools/call