BidProwl

Working · 1.5 s

com.bidprowl/bidprowlv1.0.0 Domain verified

US government surplus auctions: search live lots by ZIP radius, sold prices and Flip Scores.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://bidprowl.com/api/v1/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

flip_score

BidProwl's deal score for a live listing, with its condition-adjusted tier.

idstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (7)

flip_score

BidProwl's deal score for a live listing, with its condition-adjusted tier.

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    }
  }
}

get_api_usage

This API key's plan, monthly call limit, calls used, calls remaining and when the quota resets (first of next month, UTC). Free to call: it does not count against the quota.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

get_listing

Fetch a single listing by its BidProwl id or slug.

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string"
    }
  }
}

get_sold_history

The actual sold lots behind a comps number, newest close first: title, final price (cents), close date, state, source, BidProwl link. Pass one of category, item (tracked item slug) or q (free text, matched like a listing title), plus optional state. Paginate with cursor.

Argument	Type	Description
q	string	Pro: free text, e.g. 2015 ford f150
item	string	Pro: tracked item slug, e.g. forklift
limit	integer	Default 25
state	string
cursor	string	next_cursor from the previous call
category	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Pro: free text, e.g. 2015 ford f150"
    },
    "item": {
      "type": "string",
      "description": "Pro: tracked item slug, e.g. forklift"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Default 25"
    },
    "state": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous call"
    },
    "category": {
      "type": "string"
    }
  }
}

search_listings

Search 90,000+ live US government surplus auction listings from 27 official sources. Supports keyword, category, state, ZIP-radius, and price filters.

Argument	Type	Description
zip	string	Center a radius search on this ZIP
page	integer
sort	string
limit	integer	Results per page, default 25
query	string	Keyword search, e.g. 'forklift'
state	string	2-letter US state code
category	string
radius_miles	integer
price_max_usd	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "zip": {
      "type": "string",
      "description": "Center a radius search on this ZIP"
    },
    "page": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "sort": {
      "enum": [
        "ending_soon",
        "newest",
        "price_low",
        "price_high",
        "most_bids",
        "best_deals"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page, default 25"
    },
    "query": {
      "type": "string",
      "description": "Keyword search, e.g. 'forklift'"
    },
    "state": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "2-letter US state code"
    },
    "category": {
      "type": "string"
    },
    "radius_miles": {
      "type": "integer",
      "maximum": 300,
      "minimum": 1
    },
    "price_max_usd": {
      "type": "number"
    }
  }
}

sold_comps

Sold-price stats from 250,000+ closed government auctions, nearly all from the last 12 months. Category+state aggregates, or exact percentile comps for a live listing via listing_id.

Argument	Type	Description
state	string
category	string
listing_id	string	Pro: exact comps for this live listing

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "state": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
    },
    "category": {
      "type": "string"
    },
    "listing_id": {
      "type": "string",
      "description": "Pro: exact comps for this live listing"
    }
  }
}

sold_comps_batch

Up to 25 sold_comps lookups in one call (100 on Pro+), each costing one API call. Each query is a listing id, a tracked item slug ("forklift"), a category ("vehicles"), or text naming a tracked item ("2015 Ford F150"). Item-level and per-listing answers need Pro or Pro+; categories work on every plan. Amounts are in cents.

Argument	Type	Description
state	string	Default 2-letter state for item and category queries
queries*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "queries"
  ],
  "properties": {
    "state": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Default 2-letter state for item and category queries"
    },
    "queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "minItems": 1
    }
  }
}