# VIN Price Check

Canonical URL: https://ai.marketcheck.com/ai/docs/reports/vin-price-check/

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

This is the technical reference. For the price, a rendered sample and answers to common questions, see the [VIN Price Check product page](https://ai.marketcheck.com/reports/vin-price-check).

## 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 advertised-price timeline and the distinct sellers 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: private sellers' ads, marketplace copies and auction records are left out, and so are records from the other country (Canada or the US), which are listed apart in their own currency. 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 JTMN1RFV5MD071476 was ever advertised at?
>
> Price check these 8 VINs and tell me the cost first: <paste VIN list>.

## Running it from a backend

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

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

See [Server-side access](https://ai.marketcheck.com/ai/docs/server-side-access/) for the token exchange and how to read the response.
