AI Storefront
Browse the documentation

Sold-Market Price Check

What sellers listed this exact car for before it sold in your state, the best month to buy, and what is popular near you.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Sold-Market Price Check product page.

At a glance

Price $0.99 per run.
Tool name generate_sold_market_price_check
Scope reports:sold-market-price-check
Built for Car Shopper

What it does

The shopper's price check for one exact car (year, make, model and trim) in one US state: the middle half of the advertised asking prices these cars carried when they left dealer websites in the latest month (Low end to High end, the 25th to 75th percentile), with the median, the 95th percentile, the median odometer, how many days they took to sell and n, the priced sales behind it. With fewer than 5 priced sales of the exact trim it drops the trim and says so, then widens to national and says so, and with fewer than 5 even then it reports no range rather than a guess. Adds the cheapest and dearest month of the last 12 for the model in the state (the months to buy in) and, with a city, the ten cars that left that city's dealer websites most in the latest month. Three plain-English takeaways close it. Optionally positions an asking price you have been quoted against the range. Every figure is an advertised asking price at the time the car left the dealer's website, never a negotiated or paid price: the range to negotiate inside. Use when a car shopper asks what a specific year, make, model and trim lists for in their state before it sells, whether a quoted price is fair, when the best month to buy is, or what people near them are buying. Do NOT use to vet a specific listing by VIN (use Used Car Health Check), to write the offer and the script (use Negotiation Brief), or to value a trade (use Trade-In Valuation Report). The sold data has state and city grain, not ZIP or radius; a ZIP is read as its state. PRICING: $0.99 per run.

Arguments

Argument What it is Example
year Required Model year of the car (e.g. 2022). 2022
make Required Make (e.g. Hyundai). Hyundai
model Required Model (e.g. Tucson). Tucson
state Required The shopper's US state, as a 2-letter code (e.g. NJ). A 5-digit ZIP is read as its state. The sold data has state and city grain only, no ZIP or radius. NJ
trim Recommended Trim (e.g. SEL). With fewer than 5 priced sales of the exact trim the range covers every trim, and the report says so. SEL
city Recommended The shopper's city (e.g. Newark), for the popular-near-you list. Falls back to the state when the city is thin. Newark
asking_price_usd Optional A price the shopper has been quoted, positioned against the range (under the Low end, in the middle half, above the High end). 21500
inventory_type Optional Which market: used (the default), new, or certified pre-owned. used

What comes back

Asking for it in a chat client

What do 2022 Hyundai Tucson SELs list for in New Jersey before they sell, and when is the best month to buy?

Is $21,500 fair for a 2021 Civic EX in Ohio?

Running it from a backend

Grant an agent the reports:sold-market-price-check scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_sold_market_price_check",
    "arguments": {
      "year": 2022,
      "make": "Hyundai",
      "model": "Tucson",
      "trim": "SEL",
      "state": "NJ",
      "city": "Newark"
    }
  }
}

See Server-side access for the token exchange and how to read the response.