AI Storefront
Browse the documentation

Regional Discount & Scarcity Map

Where a brand or model is discounted hardest and where it sells at or above sticker, state by state, with days to sell as the scarcity tell.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Regional Discount & Scarcity Map product page.

At a glance

Price $9.99 per run.
Tool name generate_regional_discount_map
Scope reports:regional-discount-scarcity-map
Built for Automaker

What it does

The regional discount and scarcity map for one brand, or one model, from Sold Summary API v2 at state grain: every state where at least 25 units left dealer websites in a month of the window (3 months by default), deepest discount first by the gap to sticker (the average advertised asking price at exit against the average listing MSRP), with units over the window, the median days to sell, the median asking price and the priced sample, each state's figures from its latest month with 30 or more priced sales (named in the table). Two flags: Scarcity for a state at or above sticker whose days to sell sit in the fastest quarter of the states, Deep discount for the deepest quarter of gaps. Adds the brand's national sticker-gap line over 12 months with the deepest month and the month nearest sticker, and three findings from the numbers: where the discount is deepest, where sticker holds and scarcity shows, and which way the national gap is moving. New vehicles by default. From the Sold Summary API: a sale is inferred when a listing leaves a US dealer website, every price is the advertised asking price against MSRP at the time the vehicle left the website; incentives, dealer cash and negotiated prices are not observed, so the map is the advertised floor of discounting. Use when a regional, incentive or allocation team asks where a brand or model is discounted hardest, where it holds or beats sticker, which states show scarcity (fast turns at or above sticker), or which way the national gap is moving. Do NOT use for the used-market price map of a nameplate by state (use the Regional Arbitrage Map), for one model's trims (use the Trim Contenting Report), or for brand share against rivals (use Brand Share & Pricing Power). State grain, not ZIP, metro or radius. PRICING: $9.99 per run.

Arguments

Argument What it is Example
make Required The brand (e.g. Nissan). Alone, the map is for the whole brand. Nissan
model Recommended A model (e.g. Telluride) to narrow the map to one nameplate. Leave blank for the whole brand. Rogue
inventory_type Optional Which market: new (the default) or used. On used vehicles the gap is against the original sticker. new
months Optional The window in months, 1 to 12, ending at the latest complete data month (3 by default). A state needs 25 sales in a month for that month to count; units add over the qualifying months and each state's gap is read from its latest month with 30 or more priced sales. 3

What comes back

Asking for it in a chat client

Where is Nissan discounted hardest, and where does it hold sticker?

Regional discount and scarcity map for the Kia Telluride

Running it from a backend

Grant an agent the reports:regional-discount-scarcity-map scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_regional_discount_map",
    "arguments": {
      "make": "Nissan",
      "inventory_type": "new",
      "months": 3
    }
  }
}

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