About Govauctions
Govauctions provides agents and code with government-surplus auction data, including live listings, sold-price comparisons, and resale signals. It covers multiple markets and can be used through a hosted endpoint or a local npm package.
Key features
- 01Search and retrieve live GSA listings
- 02Get sold-price ranges across markets
- 03Review individual sales and monthly trends
- 04Get Flip Score resale signals
- 05Check pricing coverage and API usage
Use cases
- 01Filter live government-surplus auction listings
- 02Compare historical sale prices across markets
- 03Assess an item's resale value and discount
MCP support
The hosted MCP server exposes read-only auction-data tools over Streamable HTTP; the local npm package connects to the REST Data API over stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://govauctions.app/api/mcpclaude mcp add --transport http govauctions https://govauctions.app/api/mcp{"mcpServers":{"govauctions":{"type":"http","url":"https://govauctions.app/api/mcp"}}}Open in Cursor{"servers":{"govauctions":{"type":"http","url":"https://govauctions.app/api/mcp"}}}Open in VS Code{"mcpServers":{"govauctions":{"type":"http","url":"https://govauctions.app/api/mcp"}}}{"mcpServers":{"govauctions":{"serverUrl":"https://govauctions.app/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
9| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Title keyword |
| zip | string | No | US 5-digit ZIP to search around. Limits results to lots within radiusMiles, orders them nearest-first, and adds distanceMiles to each. |
| sort | enum | No | 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.ending-soonest | newest |
| limit | integer | No | Rows per page. Signed out, capped at 25. |
| state | string | No | 2-letter state code |
| offset | integer | No | |
| source | enum | No | gsa |
| country | enum | No | US |
| category | string | No | |
| priceMax | number | No | |
| priceMin | number | No | |
| radiusMiles | number | No | Radius from `zip`, in miles (default 100, max 500). Requires `zip`. |
Details
From the project READMEGovAuctions 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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.