VIN Price Check

Lowest advertised price of record for a VIN (single or batch), with source and timeline.

VIN Price Check

Lowest advertised price of record for a VIN (single or batch), with source and timeline.

At a glance


Price	$0.50 per VIN. Minimum $0.50 per run. A batch is quoted before it runs: the first call returns a total and charges nothing.
Tool name	`generate_vin_price_check`
Scope	`reports:vin-price-check`
Built for	Small Dealer, Dealer Group, Independent Appraiser

What it does

Returns the lowest ADVERTISED (listed) price of record for a VIN across the dealer websites Marketcheck crawls, with the source, dealer, date, and listing URL, plus the full advertised-price timeline and every distinct seller that advertised the VIN. Pass ONE VIN (vin) for the full single-VIN view, or MANY VINs (vins, comma or newline separated) for a batch summary table. All figures are advertised prices, never sale prices. Coverage is dealer websites (near-complete, built over years), not third-party aggregator marketplaces. This is the compliance-grade lookup behind the price-check API: it establishes the advertised price of record so the dealer can compare it against their own sale price. PRICING: $0.50 per VIN. A single VIN runs immediately. A BATCH is priced per VIN and requires cost confirmation: call first WITHOUT confirm_cost_usd to get a quote (this charges nothing), show the user the exact total, and only after they approve, call again with confirm_cost_usd set to the quoted total to run and charge the batch. Batches run up to 500 VINs at a time (a full lot in one run). Use when the user asks for the lowest or advertised price one or more VINs were advertised at, a VIN advertised-price history, or a neutral advertised price-of-record (advertised-vs-sold / FTC Act Section 5 / state advertising compliance). This is the ADVERTISED price, not market value (use Vehicle Valuation) and not a lot-wide compliance audit (use Pricing Compliance Report).

Arguments

Argument		What it is	Example
`vin`	Optional	17-character VIN for a single-VIN check. Provide this OR vins.	`1HGCV2F38LA000777`
`vins`	Optional	Multiple VINs for a batch check, comma or newline separated. Priced at $0.50 per VIN; requires cost confirmation via confirm_cost_usd. Up to 500 per batch.	`1HGCV2F38LA000777, 4T3R6RFV7MU015349`
`confirm_cost_usd`	Optional	For batches only. After quoting the user the exact total and getting approval, call again with this set to the quoted total (e.g. 4.90). The batch runs and is charged only when this matches the server-computed total. Leave empty on the first (quote) call.	`4.9`
`zip`	Optional	Optional ZIP for location context. The check is VIN-keyed, so this is informational only.	`60601`

What comes back

Live cross-seller read (sellers, distinct live prices, agreement)
Lowest advertised price of record (with source link)
Current listings with freshness (days on site) and a link to each live listing
All-time advertised spread (context, not a flag)
Full advertised-price timeline (single VIN)
Per-VIN summary table (batch)

Asking for it in a chat client

What is the lowest price VIN 4T3R6RFV7MU015349 was ever advertised at?

Price check these 8 VINs and tell me the cost first: .

Running it from a backend

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

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

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