`us_auctions_search`

Pack: us-auctions · Endpoint: https://gateway.pipeworx.io/us-auctions/mcp

Search live US auction lots across every source Pipeworx indexes — commercial auction houses (HiBid: ~1,900 US auctioneers, industrial liquidations, estate and equipment sales) and government surplus/seized/tax-deed sales (GovDeals, AllSurplus, PublicSurplus, Bid4Assets, IRS). Filter by free-text keyword (matched on the lot title, e.g. “forklift”, “excavator”, “F-150”), 2-letter state, asset_type (vehicle|equipment|realestate|electronics|other), segment (commercial|government), auction_house, max_price and closing_within_hours — or search geographically with near_zip + radius_miles (“forklifts within 50 miles of 94402”), which returns lots ordered by distance. Keyword search is full-text over the lot title AND description, so “cnc lathe” finds a lot titled “Haas TL-1” whose description says CNC lathe. Returns each lot with source, title, selling house, location, current bid, close time and a link. For what things actually SOLD for, use us_auctions_sold_comps instead.

Parameters

Name	Type	Required	Description
`keyword`	string	no	Free-text matched (case-insensitive) against the lot title, e.g. “forklift”, “skid steer”, “mac pro”.
`state`	string	no	2-letter state code of the item location, e.g. “CA”, “TX”.
`asset_type`	string	no	One of: ${ASSET_TYPES.join(’ \| ’)}.
`segment`	string	no	Restrict to one half of the market: ${SEGMENTS.join(’ \| ’)}. Omit for both.
`source`	string	no	Restrict to one source: hibid \| govdeals \| allsurplus \| publicsurplus \| bid4assets \| irs \| txauction.
`auction_house`	string	no	Selling auctioneer, matched as a substring, e.g. “Silicon Valley Disposition”.
`near_zip`	string	no	US 5-digit ZIP to search around, e.g. “94402”. Combine with radius_miles for “what is up for auction near me”. Results come back ordered by distance and carry distance_miles.
`radius_miles`	number,string	no	Radius around near_zip, in miles (1-500, default 50). Ignored unless near_zip is given.
`max_price`	number,string	no	Only lots whose current bid is at or below this. Note that a lot with no bids yet has no current bid and is excluded.
`closing_within_hours`	number,string	no	Only lots closing within this many hours from now.
`limit`	number,string	no	Max lots (1-100, default 25).

Example call

Arguments

{
  "keyword": "forklift",
  "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_auctions_search","arguments":{"keyword":"forklift","limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('us_auctions_search', {
  "keyword": "forklift",
  "limit": 10
});

More examples

{
  "keyword": "cnc lathe",
  "segment": "commercial",
  "limit": 10
}

{
  "near_zip": "94402",
  "radius_miles": 75,
  "asset_type": "equipment",
  "limit": 10
}

{
  "state": "CA",
  "asset_type": "vehicle",
  "closing_within_hours": 48,
  "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.

us_auctions_search