Connect an assistant

Vehicle Valuation Report

Defensible market valuation for any VIN with comparables and history.

Vehicle Valuation Report

Defensible market valuation for any VIN with comparables and history.

At a glance
Price $1.99 per run.
Tool name generate_vehicle_valuation_report
Scope reports:vehicle-valuation
Built for Small Dealer

What it does

Defensible market valuation for any VIN, anchored on recently off-market listings (last list price, the closest observable proxy to a transaction), with dual-channel pricing (franchise vs independent), comparable listings, listing history, and 90-day market trend. All figures are listed prices. Use when the user wants the market value, appraisal, or fair price of ONE specific vehicle (by VIN, or year/make/model). Single vehicle only. Do NOT use this to rank or compare MULTIPLE VINs the user is deciding whether to buy (use Acquisition Fit Report, which ranks a whole list in one call), to get a VALUE on each of multiple VINs (use Batch Vehicle Valuation: one sheet row per unit), for a consumer trade-in or sell-private decision (use Trade-In Valuation), or for the advertised price of record / FTC compliance (use VIN Price Check).

Arguments

Argument What it is Example
vin Required 17-character vehicle identification number. 1HGCV2F38LA000777
miles Recommended Current odometer reading. STRONGLY RECOMMENDED, without this we estimate from model year and get the wrong number for high or low mileage vehicles. 50000
zip Recommended ZIP code of the appraisal market (where the vehicle is being bought, sold, or appraised). STRONGLY RECOMMENDED, defaults to 90210 if missing, which produces wrong regional comparables. 60601
condition Optional Vehicle condition: "Clean" (no body damage, well maintained), "Average" (typical wear), or "Rough" (visible damage, deferred maintenance). Biases the final range toward low/mid/high. Clean
purpose Optional Purpose of the valuation: "Trade-in" (lower end), "Retail" (upper end), "Insurance" (replacement cost), or "Wholesale" (auction). Influences the recommended range bias. Trade-in
is_certified Optional Tick this if the vehicle is currently CPO (certified pre-owned). Adds the CPO premium analysis to the report. false
asking_price_usd Optional Optional asking/listed price to sanity-check. When provided, the report verdicts it against the MarketCheck Price and the active market and plots it on the price-band chart. If omitted and this VIN is itself currently listed, its own asking price is used. 30995
target_margin_pct Optional Dealer target margin as a decimal (e.g. 0.15). With purpose "Trade-in" or "Wholesale", produces the offer worksheet (retail-back offer). 0.15
recon_cost_usd Optional Expected reconditioning cost for THIS unit. Feeds the offer worksheet. 1500
adjustments Optional Itemized appraiser adjustments, one per line as "label, +/-amount" (e.g. "Two tires, -400" or "Aftermarket wheels, +800"). Applied over the market-derived base value as an explicit adjustments table. Two tires, -400
appraiser_name Optional Appraiser or preparer name for the certification block. Defaults from the appraisal profile in account settings on appraisal-flavored runs; a value typed here always wins. Jane Smith, ASA
appraiser_license Optional License or credential shown with the preparer name. Defaults from the appraisal profile in account settings. UT Lic. 12345
client_name Optional Client the appraisal is prepared for (renders in the certification block). Acme Insurance
file_number Optional Claim / file / stock reference number for the certification block. Leave blank to auto-assign the next number in your account's own series (e.g. ACME-2026-0007; set the prefix in account settings) whenever appraiser fields are used. CLM-2026-0417
exclude_vins Optional Comparables to EXCLUDE (comma or newline separated VINs). They are dropped from every pool before valuation and listed as considered-and-rejected.

What comes back

Asking for it in a chat client

What's this Toyota worth? VIN 4T3R6RFV7MU015349, 42,800 miles, ZIP 60601.

It's listed at $30,995. Is that a fair price? VIN 4T3R6RFV7MU015349, 42,800 miles, ZIP 60601.

Running it from a backend

Grant an agent the reports:vehicle-valuation scope, then call the tool over MCP:

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

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