Wine details
Reference details for one wine: producer, country, region, colour, vintage, pack size, critic score, drinking window and product page, with its Cru market price, last traded price, and every bid and offer on it (empty when there are none). Prices are normal amounts in the market currency - 12345.5 is 12,345.50 - and every market states its currency.
Marked readOnlyHint, so an assistant may call it without asking the customer first.
Arguments
1 REQUIRED| ARGUMENT | DESCRIPTION |
|---|---|
| lwin18string · 18 digits · required | The wine's LWIN18, from search_wines. |
Any other argument is refused with a tool error that lists what the tool accepts. Numbers may also be sent as strings, and booleans as "true" or 1.
Returns
STRUCTUREDCONTENTwine: every search field, plus short_name, country, sub_region, is_cask, score, drinking_window, currency, last_trade, and every bid and offer — those two only when the connection also holds market:read.
The same object also comes as JSON text in content, for hosts that read only that.
Errors
A refusal — a wine that is not on Cru, a price out of range — comes back as a result with isError: true and a message worded for the assistant to act on. A connection without wines:read is not offered this tool, and calling it anyway returns 403 with a JSON-RPC error naming the scope. Missing or invalid credentials return 401. Conventions every tool shares →