`README.md`

21 lines
# govauctions-mcp

MCP server exposing **live US government auction listings** via the free official
[GSA Auctions API](https://gsa.github.io/auctions_api/). No scraping, no bot-wall.

## Tools
- `search_auctions({ keyword?, state?, agency?, openOnly?, limit? })` — search active federal-surplus auctions.
- `get_auction({ saleNo, lotNo? })` — one lot's full detail.
- `auction_summary()` — totals + breakdown by state/status.

## Config (~/.claude.json)
```json
"govauctions": {
  "type": "stdio",
  "command": "/opt/homebrew/bin/node",
  "args": ["/Users/macstudio3/Projects/govauctions-mcp/govauctions-mcp.mjs"],
  "env": { "GSA_API_KEY": "DEMO_KEY" }
}
```
`GSA_API_KEY` defaults to the public `DEMO_KEY`; get a free higher-limit key at https://api.data.gov/signup/.