search_auctions
List lots in Okun Koneosa's online auction (huutokauppa).
The auction sells new and used machines, tools and supplies. Use this when the customer asks about the auction, used machines or bidding. Auction lots are NOT in search_catalog: they are single items sold to the highest bidder.
Args: query: Optional Finnish keyword matched against title, description, manufacturer, model and condition. Leave empty to list all lots. limit: Maximum lots to return (1-20, default 10).
Returns: JSON with status ('open', 'coming' or 'closed'), opens_label when the auction opens later, section_url, terms_url and lots. Each lot has title, condition, current_price, min_next_bid, bid_count, ends_at, pickup_town, delivery, vat and lot_url.
Notes:
- Bidding is not possible through this tool. Share lot_url; the customer
bids on the lot page with their own account.
- A bid in the last 3 minutes extends ends_at by 3 minutes, so prices
and end times change. Fetch again rather than reusing old values.
- Some used lots are sold under the margin scheme: VAT is included but
not itemised, and a business buyer cannot deduct it (see vat).
- For auction rules (payment, pickup, withdrawal right) use
search_shop_policies_and_faqs with query "huutokauppa".
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": "search_auctions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max lots (1-20) | |
| query | No | Optional Finnish keyword, e.g. 'porakone', 'pyörä' |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lots | No | ||
| note | Yes | How the agent should present the lots to the customer | |
| query | No | ||
| total | Yes | Matching lots across all results | |
| status | Yes | 'open', 'coming' (opens later, see opens_label) or 'closed' | |
| opens_at | No | UTC ISO 8601 when status is 'coming' | |
| terms_url | No | Auction terms page (when open) | |
| opens_label | No | Opening time in Finnish | |
| section_url | No | Auction front page |