{
  "markdown": "# GovAuctions MCP server\n\n[**GovAuctions.app**](https://govauctions.app) is a free public site for finding\ngovernment surplus auctions: live listings from GSA and other government sellers,\nalongside what comparable lots actually sold for. This repo is its MCP server, a\nsecond front door onto the same data for agents and code.\n\nAgent-callable tools for **government-surplus auction data**: search live listings,\npull real sold-price comps, and get a 0–100 Flip Score resale signal, from the same\nengine behind the site.\n\n## Tools\n\nFour tools, all read-only.\n\n| Tool | What it does |\n|------|--------------|\n| `search_listings` | Search live surplus auction listings (facts only). Filter by country, state, category, source, keyword, price. |\n| `get_listing` | Fetch one listing by id (live or archived). |\n| `get_sold_comps` | Sold-price range (25th / median / 75th percentile) for a described item, from past government auctions. |\n| `get_flip_score` | Flip Score resale signal for a listing: estimated value, effective bid, and discount. |\n\nGet an API key (free tier available) at\n**https://govauctions.app/developers**.\n\n## Use it (two ways)\n\n### 1. Hosted (remote) — no install\n\nPoint any client that speaks remote MCP at the hosted Streamable HTTP endpoint:\n\n```json\n{\n  \"mcpServers\": {\n    \"govauctions\": { \"url\": \"https://govauctions.app/api/mcp\" }\n  }\n}\n```\n\n`get_sold_comps` is open on the hosted endpoint; the other three tools read your\nkey from the request. See the [developer docs](https://govauctions.app/developers).\n\n### 2. Local (stdio) — this file\n\nA dependency-free Node wrapper (Node 18+) over the REST Data API. Download\n[`govauctions-mcp.mjs`](./govauctions-mcp.mjs) and add it to your client:\n\n```json\n{\n  \"mcpServers\": {\n    \"govauctions\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/govauctions-mcp.mjs\"],\n      \"env\": { \"GOVAUCTIONS_API_KEY\": \"gak_your_key\" }\n    }\n  }\n}\n```\n\nConfig (env):\n\n- `GOVAUCTIONS_API_KEY` — required. Your key from https://govauctions.app/developers/keys\n- `GOVAUCTIONS_API_BASE` — optional. Defaults to `https://govauctions.app/api/v1`\n\n## API\n\nThe tools wrap the public REST Data API. OpenAPI spec:\nhttps://govauctions.app/api/v1/openapi.json\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 2261,
  "sha": "66155f7aa5d9db9d357e225f92ff9b5093afd18bfc97b23b6e2fb744ef464be4",
  "repo_slug": "benswork-space/govauctions-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_app_govauctions_govauctions_3c3c1dbf/readme"
}