Buyer's Market Scan
Every matching dealer listing near you, new listings and price drops first.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Buyer's Market Scan product page.
At a glance
| Price | $4.99 per run. |
| Tool name | generate_buyer_market_scan |
| Scope | reports:buyer-market-scan |
| Built for | Car Shopper |
What it does
For a car shopper who knows what they want. Scans dealer websites within the chosen radius of the shopper's ZIP (50 miles by default) for every listing that matches up to 3 makes and models (or a body type such as SUV), the year, price and mileage limits and up to 5 must-have features. Returns the cars first listed in the last 7 days, the asking-price drops of the last 7 days (largest cut first), every current match (the nearest 300 in a large market) with its dealer, distance and up to 4 equipment highlights, each car's asking price against a named basis (its own MarketCheck Price, similar cars at its mileage, or the sticker price for new cars), the matches by model and by dealer, and a day-by-day count of new listings and price drops for the previous 7 days. Dealer websites only (no marketplaces, private sellers or auctions); every price is a dealer asking price. Use when a CONSUMER is shopping for a car and asks what is for sale near them within a budget, which listings are new this week, or which ones dropped in price. For ONE specific listing use Pre-Purchase Negotiation Brief (what to offer) or Used Car Health Check (its history); for what the shopper's own car is worth use Trade-In Valuation Report.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
zip |
Required | The shopper's 5-digit US ZIP code. Dealer websites within radius_miles of it are searched. | 75201 |
vehicles |
Recommended | Up to 3 makes and models, one per line or separated by semicolons, as "Make | Model | Trims" (trims optional, comma separated), e.g. "Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V". "Toyota RAV4" also works. Leave empty and set body_type to search a whole body type instead. | Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V |
body_type |
Recommended | Use when no specific model is given: every make and model of this body type. Ignored when vehicles is set. | SUV |
car_type |
Optional | Used (the default), New, or Certified for certified pre-owned only. | used |
year_min |
Optional | Oldest model year to include. | 2021 |
year_max |
Optional | Newest model year to include. | 2024 |
price_min_usd |
Optional | Lowest asking price to include, in USD. | 20000 |
price_max_usd |
Optional | Highest asking price to include, in USD (the shopper's budget). | 36000 |
miles_max |
Optional | Highest odometer reading to include. | 60000 |
features |
Optional | Up to 5 must-have features, comma separated; every match has all of them. Choose from: Sunroof, Panoramic roof, Leather seats, Heated seats, Heated and cooled seats, Third-row seats, Navigation, Apple CarPlay, Android Auto, Adaptive cruise control, Blind spot monitor, Lane keep assist, 360 camera, Remote start, Power liftgate, Premium audio, Wireless charging, Head-up display, Memory seats. | Sunroof, Heated seats |
radius_miles |
Optional | How far from the ZIP to search, 10 to 100 miles. | 50 |
drivetrain |
Optional | awd (all-wheel or four-wheel drive), fwd (front-wheel drive) or rwd (rear-wheel drive). | awd |
powertrain |
Optional | gas, hybrid, phev (plug-in hybrid) or ev (electric). | hybrid |
dealer_type |
Optional | franchise (new-car brand dealers) or independent dealers only. | franchise |
clean_title_only |
Optional | Only cars whose dealer reports a clean title. | false |
one_owner_only |
Optional | Only cars whose dealer reports a single previous owner. | false |
What comes back
- Cars first listed in the last 7 days
- Asking-price drops in the last 7 days, largest cut first
- Every current match with its dealer, distance and equipment highlights
- Each car against its own MarketCheck Price or similar cars at its mileage
- Matches by model and by dealer
- New listings and price drops, day by day, for the past week
Asking for it in a chat client
Find me a used Toyota RAV4 or Honda CR-V near 75201: 2021 or newer, under 60,000 miles, $20,000 to $36,000, with a sunroof.
Which used 4WD pickups under $45,000 were listed or cut their price this week near 80202?
Running it from a backend
Grant an agent the reports:buyer-market-scan scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_buyer_market_scan",
"arguments": {
"zip": "75201",
"vehicles": "Toyota | RAV4 | XLE, XLE Premium; Honda | CR-V"
}
}
}
See Server-side access for the token exchange and how to read the response.