govauctions.app

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Live listings, sold prices and resale scores from GovAuctions.app, the public surplus-auction site.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "govauctions.app": {
      "url": "https://govauctions.app/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• search_listings read-only

  Search live GSA federal-surplus auction listings (facts only — no images). Filter by state, category, keyword, price, or distance from a US ZIP code. Works signed out (up to 25 rows per page). Raw listings cover sanctioned federal sources; sold-price comps span the full market.

  Parameters:

  • q — string — Title keyword
  • zip — string — US 5-digit ZIP to search around. Limits results to lots within radiusMiles, orders them nearest-first, and adds distanceMiles to each.
  • sort — string — Result order. Default is soonest-ending (nearest-first when `zip` is given). Use `newest` to order by the lot's own listing date, newest first - that is the ordering a recurring "what is new" check needs, because under the default a brand-new lot can sit anywhere in the results.
  • limit — integer — Rows per page. Signed out, capped at 25.
  • state — string — 2-letter state code
  • offset — integer
  • source — string
  • country — string
  • category — string
  • priceMax — number
  • priceMin — number
  • radiusMiles — number — Radius from `zip`, in miles (default 100, max 500). Requires `zip`.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_listing read-only

  Get one live GSA listing by its id (facts only). Works signed out.

  Parameters:

  • id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_sold_comps read-only

  Sold-price comps for a described item, computed across the full government-surplus market in any market listed in `country`. Signed out: coverage (how many comparable sales, confidence, a coarse price band) plus `categoryStats`, the 25th/median/75th percentile of every sale in the item's category (in `state` when it has enough sales). Signed in or with an API key: the 25th/median/75th percentile for this item itself. `liveListingsUrl` links to the live auctions for the same item. A miss says which kind it is: reason `insufficient_comps` (too few comparable sales yet) is worth retrying, reason `category_not_priceable` (real-estate) never is — that category cannot be priced from a title. A catch-all `category` such as `miscellaneous` is not refused: it is dropped and the item is priced on its title alone, with `requestedCategory` and `categoryDropped` echoed back — check the resolved `category` and `confidence` before trusting the range. A miss can still carry `categoryStats` when the item's category is clear, and `retryHint` when the query was a long listing title: retry with just the brand and model.

  Parameters:

  • q (required) — string — Item description, e.g. '2015 Ford F-150'
  • limit — integer — How many underlying sales to return with include=comps. Capped by plan.
  • state — string — Optional 2-letter state/region code for a regional range. Falls back to the national range when that state has too few sales; the response's `scope` field says which you got.
  • country — string
  • include — string — Set to "comps" to also return the individual sales the range was computed from (title, final price, sale month, state). Requires a key; the number returned is capped by plan. Not served for EU markets (DE, FR, NL, PL): the range is returned with `compsWithheld: true`.
  • category — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_sold_comps_batch read-only

  get_sold_comps for a list of items in one call. Each query is either a string ('2015 Ford F-150') or an object with its own q/category/country/state. Each item costs one valuation lookup, exactly as if sent alone; an item that comes back without a range is not charged. If the monthly allowance runs out part-way, the items already priced are returned and `batch.truncated` names the rest. Batch size is capped by plan (10 on the free allowance). Requires sign-in or an API key.

  Parameters:

  • queries (required) — array
  • state — string — Default 2-letter state/region code for every query.
  • country — string — Default market for every query.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_flip_score read-only

  GovAuctions Flip Score resale signal for one live lot, from any source, in any market with sold-price comps (valued against that market's comp archive): estimated value, effective bid, discount, and the link to the lot on its source site. Pass the lot id as it appears in a govauctions.app lot URL. Requires sign-in or an API key.

  Parameters:

  • id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_sold_history read-only

  The individual archived sales behind an item: title, final price, sale month and state, plus the range they produce. Use when you want the evidence rather than just the number. Query-anchored — describe an item; there is no way to list the archive. Requires sign-in or an API key.

  Parameters:

  • q (required) — string — Item description, e.g. '2015 Ford F-150'
  • limit — integer — How many sales to return. Capped by plan.
  • state — string — Optional 2-letter state/region code.
  • country — string
  • category — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_price_trend read-only

  Month-by-month median sale price for an item, plus the first-to-last change — 'is this category softening?'. Computed from the same comps as get_sold_comps, so it never contradicts that range. Returns an empty series when too few months clear the sample threshold. Requires sign-in or an API key.

  Parameters:

  • q (required) — string — Item description, e.g. 'forklift'
  • state — string — Optional 2-letter state/region code.
  • country — string
  • category — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_comp_coverage read-only

  How much sold-price data we hold per category for a market, and which categories can never be priced. Check this before building on the comps tools — it is the honest answer about what we cannot do. Works signed out.

  Parameters:

  • country — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_api_usage read-only

  This key's usage for the current month: total calls and the separate valuation allowance (which comps, sold history, trend and flip-score draw down), plus the reset date. Call it to pace a long run instead of hitting a 429 mid-task. Every other signed-in tool result already carries the same numbers in `_meta.usage`, so this is rarely needed. Free: it does not count against either allowance. Requires sign-in or an API key.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.