Connect an assistant

Lot Pricing Scan

Scan your entire lot for under-priced and over-priced vehicles.

Lot Pricing Scan

Scan your entire lot for under-priced and over-priced vehicles.

At a glance
Price $0.12 per vehicle. Minimum $1.99 per run. A batch is quoted before it runs: the first call returns a total and charges nothing.
Tool name generate_lot_pricing_scan
Scope reports:lot-pricing-scan
Built for Small Dealer, Dealer Group

What it does

Scans a dealer's live inventory (up to 1,000 units per run), prices EVERY advertised-price unit against its own channel-aware, CPO-aware MarketCheck Price, and flags under- and over-priced vehicles with a 5-band verdict per VIN (Below / Modestly Below / At / Modestly Above / Above Market). Also: aging buckets, a dealer-economics read for the typical unit (price to market, cost to market, front-end gross), specific price moves with dollar amounts, and a full per-VIN CSV download for the dealer's repricing tool. Use when the user (a dealer) asks to scan their own lot/inventory to find under- or over-priced vehicles or recommend price changes against the live market: this is the repricing tool with exact dollar moves per unit. Also works on a COMPETITOR's lot: pass the rival's website domain to see how they are priced. For the market-wide movement briefing (competitor stocking, cuts, velocity, the lot judged against market pace) use Full Market Capture; for advertised-price / FTC compliance auditing use Pricing Compliance Report; to rank candidate VINs to acquire use Acquisition Fit Report. PRICING: metered at $0.12 per vehicle scanned, with a $1.99 minimum, up to 1,000 vehicles per run. You pay only for the vehicles actually found. A scan whose limit could cost more than the $1.99 floor requires cost confirmation: call first WITHOUT confirm_cost_usd to get an up-to quote (this charges nothing), show the user the cap, and only after they approve, call again with confirm_cost_usd set to the quoted cap.

Arguments

Argument What it is Example
dealer_id Recommended mc_dealer_id from any Marketcheck listing, OR the dealer's website domain (e.g. dthondachicago.com). Defaults to the user's linked dealership if set. 1192176
hint_zip Required ZIP code at the dealer's lot. REQUIRED in practice: the underlying search uses a tight radius (5-25 mi) anchored on this ZIP to locate the dealer's inventory. 60610
limit Optional Maximum vehicles to scan and price-check (default 50, max 1000). Metered at $0.12 each above the $1.99 floor. 50
confirm_cost_usd Optional Only when the scan could cost more than the $1.99 floor. After quoting the user the up-to cap and getting approval, call again with this set to the quoted cap (e.g. 4.00). The scan runs and is charged for vehicles actually scanned, never above the cap. Leave empty on the first (quote) call. 4
target_margin_pct Optional Dealer's target margin for "what should it really sell at" calc. Defaults to 0.15 (15%). 0.15
recon_cost_usd Optional Typical reconditioning cost per unit, used in recommended-action math. Defaults to $1,500. 1500

What comes back

Asking for it in a chat client

Scan our lot for under-priced and over-priced cars. Dealer maplegrovetoyota.com, hint ZIP 60601, up to 30 vehicles.

Which cars on my lot need a price drop this week? Maple Grove Toyota in 60601.

Running it from a backend

Grant an agent the reports:lot-pricing-scan scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_lot_pricing_scan",
    "arguments": {
      "hint_zip": "60610"
    }
  }
}

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