---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/record-collector
---
# Record Collector

Look up vinyl, CD, cassette, and box-set releases across Discogs and MusicBrainz. Identify specific pressings by catalog number, barcode, or matrix inscription. Check prices by condition, browse active Discogs listings, search global marketplaces for deals, and estimate collection value.

- **Version:** 0.03
- **Categories:** search, data
- **Workflow:** search_releases → release_details → price_guide → identify_pressing → price_guide → marketplace_listings → search_releases → edition_match → price_guide → market_search → artist_discography → release_details → price_guide → label_catalog → release_details → collection_value

## Skills (10)

### Search Releases (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | No | Free-text release query such as "Nirvana Nevermind" or "Blue Note 1527" |
| `artist` | string | No | Artist or band name to match |
| `title` | string | No | Release title or album title to match |
| `format` | string | No | Preferred format such as lp, 7inch, cd, cassette, or box_set (any, lp, 12inch, 10inch, 7inch, cd, cassette, box_set, dvd, blu_ray) [default: "any"] |
| `country` | string | No | Optional country or market code such as US, UK, JP, DE, FR, or CA |
| `year` | number | No | Optional release year to bias edition matching |
| `label` | string | No | Optional label name to narrow results |
| `barcode` | string | No | Optional barcode or UPC when you want a more exact edition match |
| `catalog_number` | string | No | Optional catalog number or matrix clue such as "DGCD-24425" |
| `source` | string | No | Catalog source to search: all, discogs, or musicbrainz (all, discogs, musicbrainz) [default: "all"] |
| `sources` | array | No | Optional explicit catalog source list when you want to search multiple named sources |
| `limit` | number | No | Maximum releases to return (1-20, default 10) [default: 10] |
| `page` | number | No | Page number for search pagination (default 1) [default: 1] |

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

**Examples:**

*Search for Nevermind releases by Nirvana on vinyl:*

```json
{
  "artist": "Nirvana",
  "title": "Nevermind",
  "format": "lp",
  "limit": 8
}
```

*Find a release by catalog number and label:*

```json
{
  "catalog_number": "BNLP 1595",
  "label": "Blue Note",
  "limit": 6
}
```

*Search for Pink Floyd on Discogs only:*

```json
{
  "query": "Pink Floyd Dark Side of the Moon",
  "source": "discogs"
}
```

### Release Details (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `discogs_release_id` | number | No | Discogs release id from search_releases or identify_pressing results |
| `discogs_master_id` | number | No | Optional Discogs master id when you want the master profile plus version list |
| `musicbrainz_release_id` | string | No | MusicBrainz release id (UUID) when you want MusicBrainz metadata |
| `query` | string | No | Fallback query to resolve the best Discogs release automatically |

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

**Examples:**

*Get full details for a Discogs release by id:*

```json
{
  "discogs_release_id": 7097051
}
```

*Resolve release details from a query:*

```json
{
  "query": "Miles Davis Kind of Blue original pressing"
}
```

### Identify Pressing (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `catno` | string | No | Catalog number printed on the label or spine (e.g. "BLP 1501", "FACT 10", "PCS 7027") |
| `barcode` | string | No | Barcode or UPC from the packaging |
| `matrix` | string | No | Matrix/runout inscription etched in the dead wax near the label (e.g. "YEX-749-1") |
| `query` | string | No | General search if no specific identifiers (e.g. "Led Zeppelin I UK first pressing") |
| `artist` | string | No | Artist name to narrow results |
| `title` | string | No | Album or single title to narrow results |
| `country` | string | No | Country of pressing (e.g. "US", "UK", "Japan") |
| `year` | string | No | Year or year range (e.g. "1969", "1965-1970") |
| `format` | string | No | Format hint (e.g. "vinyl", "lp", "7"") |

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

**Examples:**

*Identify by catalog number:*

```json
{
  "catno": "BLP 1501"
}
```

*Identify by matrix inscription:*

```json
{
  "artist": "Led Zeppelin",
  "title": "Led Zeppelin I",
  "matrix": "ZAL 6535",
  "country": "UK"
}
```

*Identify by barcode:*

```json
{
  "barcode": "074643811224"
}
```

### Edition Match (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | No | Free-text release query such as "Nirvana Nevermind" or "Blue Note 1527" |
| `artist` | string | No | Artist or band name to match |
| `title` | string | No | Release title or album title to match |
| `format` | string | No | Preferred format such as lp, 7inch, cd, cassette, or box_set (any, lp, 12inch, 10inch, 7inch, cd, cassette, box_set, dvd, blu_ray) [default: "any"] |
| `country` | string | No | Optional country or market code such as US, UK, JP, DE, FR, or CA |
| `year` | number | No | Optional release year to bias edition matching |
| `label` | string | No | Optional label name to narrow results |
| `barcode` | string | No | Optional barcode or UPC when you want a more exact edition match |
| `catalog_number` | string | No | Optional catalog number or matrix clue such as "DGCD-24425" |
| `source` | string | No | Catalog source to search: all, discogs, or musicbrainz (all, discogs, musicbrainz) [default: "all"] |
| `sources` | array | No | Optional explicit catalog source list when you want to search multiple named sources |
| `limit` | number | No | Maximum releases to return (1-20, default 10) [default: 10] |
| `page` | number | No | Page number for search pagination (default 1) [default: 1] |

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

**Examples:**

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

```json
{
  "artist": "Nirvana",
  "title": "Nevermind",
  "country": "CA",
  "year": 1991,
  "catalog_number": "DGCD-24425",
  "limit": 6
}
```

### Price Guide (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `discogs_release_id` | number | Yes | Discogs release id from search_releases, identify_pressing, or edition_match results |
| `currency` | string | No | Currency code for prices (default "USD"). Supported: USD, GBP, EUR, CAD, AUD, JPY, CHF, MXN, BRL, NZD, SEK, ZAR [default: "USD"] |

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

**Examples:**

*Get price guide for a release:*

```json
{
  "discogs_release_id": 249504
}
```

*Price guide in EUR:*

```json
{
  "discogs_release_id": 249504,
  "currency": "EUR"
}
```

### Discogs Marketplace (`marketplace_listings`)

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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `release_id` | number | No | Discogs release ID from search_releases or identify_pressing results |
| `query` | string | No | Search query (alternative to release_id) — will find the best matching release |
| `currency` | string | No | Currency code for prices (default "USD"). Supported: USD, GBP, EUR, CAD, AUD, JPY, CHF, MXN, BRL, NZD, SEK, ZAR [default: "USD"] |

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

**Examples:**

*Find Discogs listings for a release:*

```json
{
  "release_id": 249504
}
```

*Search for listings by name:*

```json
{
  "query": "Radiohead OK Computer"
}
```

### Global Market Search (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | No | Free-text release query such as "Nirvana Nevermind" or "Blue Note 1527" |
| `artist` | string | No | Artist or band name to match |
| `title` | string | No | Release title or album title to match |
| `format` | string | No | Preferred format such as lp, 7inch, cd, cassette, or box_set (any, lp, 12inch, 10inch, 7inch, cd, cassette, box_set, dvd, blu_ray) [default: "any"] |
| `condition` | string | No | Optional condition hint such as used, new, sealed, or preowned (any, used, new, sealed, preowned) [default: "any"] |
| `source` | string | No | Specific market source: all, discogs, ebay, bandcamp, mercari, rakuma, yahoo_auctions_japan, cdandlp, musicstack, craigslist, and more. (all, discogs, ebay, cdandlp, musicstack, bandcamp, mercari, yahoo_auctions_japan, rakuma, facebook_marketplace, craigslist, gumtree, trademe, mercadolibre, olx, rakuten, carousell, vinted, wallapop, depop) [default: "all"] |
| `sources` | array | No | Optional explicit market source list when you want to search multiple named sources |
| `regions` | array | No | Optional region filters such as GLOBAL, US, UK, EU, JP, LATAM, APAC, NZ, AU, SG, or HK |
| `country` | string | No | Optional 2-letter country code for search localization such as us, gb, jp, de, or au |
| `language` | string | No | Optional search language code such as en, ja, de, fr, or es |
| `location` | string | No | Optional local place name to bias classifieds-style queries |
| `local_pickup` | boolean | No | Bias the search toward listings mentioning local pickup or collection [default: false] |
| `limit` | number | No | Maximum listings to return (1-25, default 10) [default: 10] |
| `page` | number | No | Page number for search pagination (default 1) [default: 1] |

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

**Examples:**

*Search global resale markets for a used vinyl copy of Nevermind:*

```json
{
  "artist": "Nirvana",
  "title": "Nevermind",
  "format": "lp",
  "condition": "used",
  "regions": [
    "GLOBAL"
  ],
  "limit": 8
}
```

*Search Japan-specific sale sources for a City Pop cassette:*

```json
{
  "query": "City Pop cassette",
  "regions": [
    "JP"
  ],
  "sources": [
    "mercari",
    "rakuma",
    "yahoo_auctions_japan"
  ],
  "limit": 8
}
```

*Find jazz vinyl auctions on eBay:*

```json
{
  "query": "Blue Note original pressing",
  "sources": [
    "ebay"
  ],
  "condition": "used",
  "limit": 10
}
```

### Artist Discography (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `artist_id` | number | Yes | Discogs artist ID — obtain from search_releases with a query like the artist name, look for the id field in results with type "artist" |
| `sort_by` | string | No | Sort releases by (year, title, format) [default: "year"] |
| `sort_order` | string | No | Sort direction (asc, desc) [default: "desc"] |
| `limit` | number | No | Results per page (1-100, default 25) [default: 25] |
| `page` | number | No | Page number (default 1) [default: 1] |

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

**Examples:**

*Browse Radiohead discography:*

```json
{
  "artist_id": 3840
}
```

*Oldest Miles Davis releases first:*

```json
{
  "artist_id": 15885,
  "sort_order": "asc"
}
```

### Label Catalog (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `label_id` | number | No | Discogs label ID — optional, use query instead if you only have the label name |
| `query` | string | No | Label name to search for (e.g. "Blue Note", "Sub Pop", "Factory Records") |
| `sort_by` | string | No | Sort releases by (year, title, catno) [default: "year"] |
| `sort_order` | string | No | Sort direction (asc, desc) [default: "desc"] |
| `limit` | number | No | Results per page (1-100, default 25) [default: 25] |
| `page` | number | No | Page number (default 1) [default: 1] |

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

**Examples:**

*Browse Blue Note Records catalog:*

```json
{
  "query": "Blue Note"
}
```

*Browse Sub Pop catalog oldest first:*

```json
{
  "query": "Sub Pop",
  "sort_order": "asc"
}
```

### Collection Value (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `items` | array | Yes | Collection rows to value. Each item can provide a discogs_release_id or a query plus an optional quantity. |

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

**Examples:**

*Estimate the value of two known Discogs releases:*

```json
{
  "items": [
    {
      "discogs_release_id": 7097051,
      "quantity": 1
    },
    {
      "discogs_release_id": 249504,
      "quantity": 2
    }
  ]
}
```

*Value a collection by query:*

```json
{
  "items": [
    {
      "query": "Miles Davis Kind of Blue mono"
    },
    {
      "query": "The Beatles Abbey Road UK first pressing"
    }
  ]
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call record-collector search_releases --artist Nirvana --title Nevermind --format lp --limit 8

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

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs