MCP 服务器

govauctions.app

app.govauctions/govauctions
电商与零售 数据与分析 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Searches government-surplus auction listings and provides sold-price comparisons, historical sales, price trends, and resale discount signals.

get_api_usage
API usage
This key's usage for the current month: total calls and the separate valuation allowance (which comps, sold history, trend and flip-score draw down), plus the reset date. Call it to pace a long run instead of hitting a 429 mid-task.
只读 幂等
输入模式
{'type': 'object', 'properties': {}}
get_comp_coverage
Comp coverage
How much sold-price data we hold per category for a market, and which categories can never be priced. Check this before building on the comps tools — it is the honest answer about what we cannot do.
只读 幂等
输入模式
{'type': 'object', 'properties': {'country': {'enum': ['US', 'UK', 'CA', 'AU', 'DE'], 'type': 'string', 'default': 'US'}}}
get_flip_score
Flip Score
GovAuctions Flip Score resale signal for one live lot, from any source, in any market with sold-price comps (valued against that market's comp archive): estimated value, effective bid, discount, and the link to the lot on its source site. Pass the lot id as it appears in a govauctions.app lot URL.
只读 幂等
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
get_listing
Get a listing
Get one live GSA listing by its id (facts only).
只读 幂等
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
get_price_trend
Price trend
Month-by-month median sale price for an item, plus the first-to-last change — 'is this category softening?'. Computed from the same comps as get_sold_comps, so it never contradicts that range. Returns an empty series when too few months clear the sample threshold.
只读 幂等
输入模式
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "Item description, e.g. 'forklift'"}, 'state': {'type': 'string', 'description': 'Optional 2-letter state/region code.'}, 'country': {'enum': ['US', 'UK', 'CA', 'AU', 'DE'], 'type': 'string', 'default': 'US'}, 'category': {'type': 'string'}}}
get_sold_comps
Sold-price comps
Sold-price comps for a described item, computed across the full government-surplus market in any market listed in `country`. Signed out: coverage only (how many comparable sales, confidence, and a coarse price band). Signed in or with an API key: the actual 25th/median/75th percentile final prices. `liveListingsUrl` links to the live auctions for the same item. A miss says which kind it is: reason `insufficient_comps` (too few comparable sales yet) is worth retrying, reason `category_not_priceable` (real-estate) never is — that category cannot be priced from a title. A catch-all `category` such as `miscellaneous` is not refused: it is dropped and the item is priced on its title alone, with `requestedCategory` and `categoryDropped` echoed back — check the resolved `category` and `confidence` before trusting the range.
只读 幂等
输入模式
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "Item description, e.g. '2015 Ford F-150'"}, 'limit': {'type': 'integer', 'description': 'How many underlying sales to return with include=comps. Capped by plan.'}, 'state': {'type': 'string', 'description': "Optional 2-letter state/region code for a regional range. Falls back to the national range when that state has too few sales; the response's `scope` field says which you got."}, 'country': {'enum': ['US', 'UK', 'CA', 'AU', 'DE'], 'type': 'string', 'default': 'US'}, 'include': {'type': 'string', 'description': 'Set to "comps" to also return the individual sales the range was computed from (title, final price, sale month, state). Requires a key; the number returned is capped by plan. Not served for EU markets (DE, FR, NL, PL): the range is returned with `compsWithheld: true`.'}, 'category': {'type': 'string'}}}
get_sold_history
Sold history
The individual archived sales behind an item: title, final price, sale month and state, plus the range they produce. Use when you want the evidence rather than just the number. Query-anchored — describe an item; there is no way to list the archive.
只读 幂等
输入模式
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': "Item description, e.g. '2015 Ford F-150'"}, 'limit': {'type': 'integer', 'description': 'How many sales to return. Capped by plan.'}, 'state': {'type': 'string', 'description': 'Optional 2-letter state/region code.'}, 'country': {'enum': ['US', 'UK', 'CA', 'AU'], 'type': 'string', 'default': 'US'}, 'category': {'type': 'string'}}}
search_listings
Search live GSA listings
Search live GSA federal-surplus auction listings (facts only — no images). Filter by state, category, keyword, price, or distance from a US ZIP code. Raw listings cover sanctioned federal sources; sold-price comps span the full market.
只读 幂等
输入模式
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Title keyword'}, 'zip': {'type': 'string', 'description': 'US 5-digit ZIP to search around. Limits results to lots within radiusMiles, orders them nearest-first, and adds distanceMiles to each.'}, 'sort': {'enum': ['ending-soonest', 'newest'], 'type': 'string', 'description': '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.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100}, 'state': {'type': 'string', 'description': '2-letter state code'}, 'offset': {'type': 'integer', 'default': 0}, 'source': {'enum': ['gsa'], 'type': 'string', 'default': 'gsa'}, 'country': {'enum': ['US'], 'type': 'string', 'default': 'US'}, 'category': {'type': 'string'}, 'priceMax': {'type': 'number'}, 'priceMin': {'type': 'number'}, 'radiusMiles': {'type': 'number', 'default': 100, 'maximum': 500, 'description': 'Radius from `zip`, in miles (default 100, max 500). Requires `zip`.'}}}
已更改
get_sold_comps
2026年9月29日 03:00
已更改
get_comp_coverage
2026年9月25日 03:00
已更改
get_price_trend
2026年9月25日 03:00
已更改
get_flip_score
2026年9月25日 03:00
已更改
get_sold_comps
2026年9月25日 03:00
已更改
get_sold_comps
2026年9月23日 02:51
已添加
get_api_usage
2026年9月17日 07:57
已添加
get_comp_coverage
2026年9月17日 07:57
已添加
get_price_trend
2026年9月17日 07:57
已添加
get_sold_history
2026年9月17日 07:57
已添加
get_flip_score
2026年9月17日 07:57
已添加
get_sold_comps
2026年9月17日 07:57
已添加
get_listing
2026年9月17日 07:57
已添加
search_listings
2026年9月17日 07:57