Get order
Read one order: items, status, shipping and the message thread with the buyer.
MCP tool discogs_read → get_order
read
Returns the items, current status, shipping details and the buyer messages in order. Use it before changing a status, because a status cannot move back to an earlier one.
Parameters
| Name | Type | Description |
|---|---|---|
| order_id string required | string | Order ID from list_orders, e.g. '1234567-89'. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "discogs_read",
"arguments": {
"operation": "get_order",
"arguments": {
"order_id": "1234567-89"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"order_id": "1234567-89",
"status": "Payment Received",
"items": [
{
"release_id": 4417820,
"title": "Night Drive / Blue Room"
}
],
"messages": [
{
"from": "sample_buyer",
"text": "Can you ship this week?",
"at": "2026-10-14T10:02:00Z"
}
]
},
"isError": false
}