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:
{
"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:
{
"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/keysGOVAUCTIONS_API_BASE: optional. Defaults tohttps://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.