List copies for sale of a release
List the copies of one release that sellers have for sale now.
MCP tool discogs_read → list_release_listings
read
Returns each copy with seller, media and sleeve condition and price, as the release page shows it. The official API gives only the number for sale and the lowest price, so this is the one read that has no API route. It does not buy anything.
Parameters
| Name | Type | Description |
|---|---|---|
| release_id integer required | integer | Release ID from search_releases. The number in discogs.com/release/{id}. |
| max_price number | number | Only copies at or below this price. |
| min_condition string | string | Lowest media condition to include, as Discogs names it, for example Very Good Plus (VG+). |
| page integer | integer | Page number, starting at 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "discogs_read",
"arguments": {
"operation": "list_release_listings",
"arguments": {
"release_id": 4417820,
"max_price": 25
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"release_id": 4417820,
"listings": [
{
"listing_id": 2290011,
"seller": "vinylbarn",
"media_condition": "Very Good Plus (VG+)",
"sleeve_condition": "Very Good (VG)",
"price": 14,
"currency": "USD"
},
{
"listing_id": 2290456,
"seller": "deepcrates",
"media_condition": "Near Mint (NM or M-)",
"sleeve_condition": "Near Mint (NM or M-)",
"price": 21.5,
"currency": "USD"
}
],
"page": 1,
"pages": 1
},
"isError": false
}