GovAuctions MCP server (app.govauctions/govauctions)

The GovAuctions.app MCP server provides access to government-surplus auction information, including live listings, comparable sold prices, and a resale signal (“Flip Score”) derived from the same engine behind the public site. It is a second front door onto the same data for agents and code.

🛠️ Key Features

Live listings from government sellers (including GSA)
Sold-price comparisons for comparable lots
0–100 Flip Score resale signal
Exposes four read-only tools for auction data
toolCount: 8

🚀 Use Cases

Search government surplus auctions for live listings
Retrieve sold-price comps for comparable lots
Use Flip Score as a resale indicator (0–100)

⚡ Developer Benefits

Agent-callable tools for government-surplus auction data
Read-only data access aligned with GovAuctions.app

⚠️ Limitations

Limited to four read-only tools (as described in the excerpt)
Provides what’s available through the underlying GovAuctions.app data engine

GovAuctions MCP server

GovAuctions.app is a free public site for finding government surplus auctions: live listings from GSA and other government sellers, alongside what comparable lots actually sold for. This repo is its MCP server, a second front door onto the same data for agents and code.

Agent-callable tools for government-surplus auction data: search live listings, pull real sold-price comps from 170,000+ closed government auctions in the US, UK, Canada and Australia, and get a 0–100 Flip Score resale signal, from the same engine behind the site.

Tools

Eight tools on the hosted server, all read-only. The local npm package exposes the first four.

Tool	What it does
`search_listings`	Search live GSA federal-surplus listings (facts only). Filter by state, category, keyword, price.
`get_listing`	Fetch one live GSA listing by id.
`get_sold_comps`	Sold-price range (25th / median / 75th percentile) for a described item, across the US, UK, CA or AU government-surplus market.
`get_flip_score`	Flip Score resale signal for a listing: estimated value, effective bid, and discount.
`get_sold_history`	The individual archived sales behind a comp number.
`get_price_trend`	Month-by-month sold-price trend for a described item.
`get_comp_coverage`	What can and cannot be priced, by category and market.
`get_api_usage`	Your key's usage against its monthly allowance.

Get an API key (free tier available) at https://govauctions.app/developers.

Use it (two ways)

1. Hosted (remote), no install. Recommended.

Point any client that speaks remote MCP at the hosted Streamable HTTP endpoint:

json

{
  "mcpServers": {
    "govauctions": { "url": "https://govauctions.app/api/mcp" }
  }
}

Claude Code:

claude mcp add --transport http govauctions https://govauctions.app/api/mcp \
  --header "Authorization: Bearer gak_YOUR_KEY"

get_sold_comps answers on the hosted endpoint with no key at all; the other tools read your key from the request. See the developer docs.

2. Local (stdio) via npx

For clients that cannot add a remote MCP URL. A dependency-free Node wrapper (Node 18+) over the REST Data API, published to npm as govauctions-mcp:

json

{
  "mcpServers": {
    "govauctions": {
      "command": "npx",
      "args": ["-y", "govauctions-mcp"],
      "env": { "GOVAUCTIONS_API_KEY": "gak_your_key" }
    }
  }
}

Or download govauctions-mcp.mjs and run it with node /absolute/path/to/govauctions-mcp.mjs.

Config (env):

GOVAUCTIONS_API_KEY: required. Your key from https://govauctions.app/developers/keys
GOVAUCTIONS_API_BASE: optional. Defaults to https://govauctions.app/api/v1

The local wrapper forwards every call to the REST API, so unlike the hosted server it needs a key for every tool, including get_sold_comps.

API

The tools wrap the public REST Data API. OpenAPI spec: https://govauctions.app/api/v1/openapi.json

License

MIT, see LICENSE.

country	string	optional
state	string	optional	2-letter state code
category	string	optional
source	string	optional
q	string	optional	Title keyword
priceMin	number	optional
priceMax	number	optional
zip	string	optional	US 5-digit ZIP to search around. Limits results to lots within radiusMiles, orders them nearest-first, and adds distanceMiles to each.
radiusMiles	number	optional	Radius from `zip`, in miles (default 100, max 500). Requires `zip`.
sort	string	optional	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	optional	Rows per page. Signed out, capped at 25.
offset	integer	optional

q	string	required	Item description, e.g. '2015 Ford F-150'
category	string	optional
country	string	optional
state	string	optional	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.
include	string	optional	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`.
limit	integer	optional	How many underlying sales to return with include=comps. Capped by plan.

queries	array	required
country	string	optional	Default market for every query.
state	string	optional	Default 2-letter state/region code for every query.

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

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

govauctions.app