us_auction_events
Pack: us-auctions · Endpoint: https://gateway.pipeworx.io/us-auctions/mcp
Upcoming US auction EVENTS — the sales themselves rather than individual lots (“Synthetic Fuels Company plant liquidation, 271 lots, Aug 28, Fremont CA”). Use this to answer “what auctions are happening near me next week” or “what is this auction house selling”. Filter by state, keyword (sale title), auction_house, and a closing date range. Returns each sale with its house, location, lot count, local sale date and a link. Sale dates are the auctioneer’s LOCAL calendar date — upstream publishes them without a timezone, so a precise instant is not available at the sale level; individual lot close times (us_auctions_closing_soon) are exact.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
state | string | no | 2-letter state code where the sale is held. |
keyword | string | no | Free-text matched against the sale title, e.g. “liquidation”, “estate”, “machine shop”. |
auction_house | string | no | Selling auctioneer, substring match, e.g. “Silicon Valley Disposition”. |
closes_after | string | no | Only sales closing on or after this date (YYYY-MM-DD). Defaults to today. |
closes_before | string | no | Only sales closing on or before this date (YYYY-MM-DD). |
min_lots | number,string | no | Only sales with at least this many lots — useful for filtering out one-off listings. |
limit | number,string | no | Max sales (1-100, default 25). |
Example call
Arguments
{
"limit": 10
}
curl
curl -X POST https://gateway.pipeworx.io/us-auctions/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"us_auction_events","arguments":{"limit":10}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('us_auction_events', {
"limit": 10
});
More examples
{
"state": "CA",
"min_lots": 50,
"limit": 10
}
{
"auction_house": "Silicon Valley Disposition",
"limit": 10
}
{
"keyword": "liquidation",
"limit": 10
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"us-auctions": {
"url": "https://gateway.pipeworx.io/us-auctions/mcp"
}
}
}
See Getting Started for client-specific install steps.