Search Discogs Catalog
discogs_searchSearch the Discogs catalog for releases, masters, artists, or labels to find release and master IDs; narrow by artist, year, format, country, catalog number, or barcode to identify an exact pressing.
Instructions
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "discogs_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page of results, from 1. | |
| type | No | What to find: release (default, a specific pressing), master (the album as a whole), artist or label. The filters apply to release and master searches only. | release |
| year | No | Only this release year. | |
| catno | No | Catalog number as printed, e.g. PB 41447. | |
| limit | No | Results per page. | |
| query | No | Free text: artist, title, label or any mix, e.g. 'Kind of Blue'. | |
| artist | No | Only this artist. | |
| format | No | Only this Format, e.g. Vinyl, CD, Cassette, LP. | |
| barcode | No | Barcode digits, or other identifier text such as a matrix/runout etching: Discogs matches it against every identifier of a Release. | |
| country | No | Only Releases from this country, e.g. UK, Japan. |