govauctions.app
Live listings, sold prices and resale scores from GovAuctions.app, the public surplus-auction site.
Open source Repository Open in the app JSON README (API)
About
Live listings, sold prices and resale scores from GovAuctions.app, the public surplus-auction site.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- app.govauctions
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.2
- Last push
- 2026-09-07T22:22:36Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:00:44
- Updated
- 2026-08-29 03:00:44
- Origin id
app.govauctions/govauctions
README
# GovAuctions MCP server
[**GovAuctions.app**](https://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, and get a 0–100 Flip Score resale signal, from the same
engine behind the site.
## Tools
Four tools, all read-only.
| Tool | What it does |
|------|--------------|
| `search_listings` | Search live surplus auction listings (facts only). Filter by country, state, category, source, keyword, price. |
| `get_listing` | Fetch one listing by id (live or archived). |
| `get_sold_comps` | Sold-price range (25th / median / 75th percentile) for a described item, from past government auctions. |
| `get_flip_score` | Flip Score resale signal for a listing: estimated value, effective bid, and discount. |
Get an API key (free tier available) at
**https://govauctions.app/developers**.
## Use it (two ways)
### 1. Hosted (remote) — no install
Point any client that speaks remote MCP at the hosted Streamable HTTP endpoint:
```json
{
"mcpServers": {
"govauctions": { "url": "https://govauctions.app/api/mcp" }
}
}
```
`get_sold_comps` is open on the hosted endpoint; the other three tools read your
key from the request. See the [developer docs](https://govauctions.app/developers).
### 2. Local (stdio) — this file
A dependency-free Node wrapper (Node 18+) over the REST Data API. Download
[`govauctions-mcp.mjs`](./govauctions-mcp.mjs) and add it to your client:
```json
{
"mcpServers": {
"govauctions": {
"command": "node",
"args": ["/absolute/path/to/govauctions-mcp.mjs"],
"env": { "GOVAUCTIONS_API_KEY": "gak_your_key" }
}
}
}
```
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`
## API
The tools wrap the public REST Data API. OpenAPI spec:
https://govauctions.app/api/v1/openapi.json
## License
MIT — see [LICENSE](./LICENSE).