Batch Vehicle Valuation

Value a whole list of VINs in one run: the daily appraisal sheet.

Batch Vehicle Valuation

Value a whole list of VINs in one run: the daily appraisal sheet.

At a glance


Price	$0.49 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_batch_vehicle_valuation`
Scope	`reports:batch-vehicle-valuation`
Built for	Small Dealer

What it does

Values a LIST of VINs in one run (up to 500): per unit, the channel-aware MarketCheck Price at its mileage, the asking price when known (provided, or pulled from the live listing), and a 5-band verdict of asking vs predicted, plus combined totals and a full CSV. Built for the dealer trade walk (a stack of trades or an auction run list) and the appraiser batch file. All figures are predicted listing prices, never transaction prices. Use when the user has MULTIPLE VINs and wants a VALUE for each (a price per unit). Do NOT use for ranking fit to a lot (use Acquisition Fit Report), for advertised-price history (use VIN Price Check), or for a single deep appraisal (use Vehicle Valuation Report). PRICING: metered at $0.49 per vehicle valued, with a $1.99 minimum, up to 500 per run. Un-valued VINs (undecodable, no usable mileage) are not billed. A run whose list could cost more than the $1.99 floor requires cost confirmation: call first WITHOUT confirm_cost_usd for an up-to quote (charges nothing), then call again with confirm_cost_usd set to the quoted cap once the user approves.

Arguments

Argument		What it is	Example
`vehicles`	Required	The vehicles to value, one per line: VIN, then optional asking price and miles (e.g. "5FNYF8H54SB000197, 37610, 14428"). Up to 500. Missing asking/miles are pulled from the VIN's current active listing when available.	`5FNYF8H54SB000197, 37610, 14428`
`zip`	Required	ZIP code of the market the vehicles are valued in.	`60601`
`dealer_type`	Recommended	"franchise" or "independent". The prediction channel; defaults to franchise (retail).	`franchise`
`confirm_cost_usd`	Optional	Only when the run 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. Charged only for vehicles actually valued. Leave empty on the first (quote) call.	`9.8`

What comes back

Combined asking vs combined MarketCheck Price across the list
Per-vehicle valuation table sorted by biggest mispricing
5-band verdict per unit (asking vs its own MarketCheck Price)
Un-valued VINs listed with reasons (never billed)
One-click CSV of the full sheet

Asking for it in a chat client

Value this run list for me (VINs with miles attached), market 84070.

Here are 30 trades from today. What is each one worth in my market?

Running it from a backend

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_batch_vehicle_valuation",
    "arguments": {
      "vehicles": "5FNYF8H54SB000197, 37610, 14428",
      "zip": "60601"
    }
  }
}

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