Dealer PluginMediumCommand

/vin-lookup

Decode any VIN for full specs, listing history, and estimated market value

$/vin-lookup VIN
Medium
Complexity
3
API Calls
$0.003 – $0.015
MC API Cost
$0.01 – $0.06
Total Cost

Purpose

/vin-lookup pulls the complete dossier on any VIN: factory specs (year, make, model, trim, engine, transmission, MSRP), full listing history across all dealers with dates and prices, and an estimated current market value at 50K miles as a baseline.

The listing history is particularly valuable for trade-in decisions — you can see how many dealers have listed the vehicle, what each one asked, and how the price trended. Multiple dealer hops or steep price drops are red flags that a single price check would miss.

Audience:Used car managersTrade-in desk managersSales consultantsWholesale buyers

Arguments

VINrequired

17-character VIN. Required — command will prompt if not provided.

How It Works

Execution flow. MCP tool calls are shown inline on each step.

01
Profile Load

Load ZIP from profile for market anchoring. UK dealers are routed to use /price-check instead — VIN lookup is US-only.

02
VIN Decodedecode_vin_neovin

Decode VIN with include_generic=true to get full factory spec sheet: year, make, model, trim, body, engine, transmission, fuel type, MSRP.

03
Listing Historyget_car_history

Pull complete listing history for the VIN sorted by date descending — every dealer that has listed this unit, with price, DOM, and status.

04
Market Value Estimatepredict_price_with_comparables

Predict market value at 50,000 miles (note: provide actual mileage for precise estimate). Uses dealer ZIP from profile.

MCP Tool Calls

ToolCallsPurpose
decode_vin_neovin1Full factory spec sheet including MSRP
get_car_history1Complete listing history across all dealers
predict_price_with_comparables1Estimated market value at 50K miles baseline

Example Output

VIN LOOKUP — 5J6RS3H7XPL002510
════════════════════════════════════════════

VEHICLE SPECS
  Year/Make/Model: 2023 Honda CR-V EX-L AWD
  Body: 4-Door SUV | Engine: 1.5L Turbo I4
  Transmission: CVT | Fuel: Gasoline
  Drivetrain: AWD | MSRP: $35,050

LISTING HISTORY (4 events)
Date        Dealer                  Price    DOM  Status
2024-11-14  Original Sale           —        —    New sold
2025-02-10  CarMax Charlotte        $30,500   28  Sold
2025-07-22  AutoNation Dallas       $29,200   41  Sold
2026-01-15  Honda Dealer Irving     $28,441   63  Active ← current

MARKET EXPOSURE
  Total market days: 132 | Unique dealers: 3
  Price journey: Started at $30,500 → now $28,441 (-6.7%)
  Multiple dealer hops — price declining with each move.

ESTIMATED VALUE AT 50K MILES
  Predicted market value: $27,800
  (Current listing at $28,441 is 2.3% above market estimate)

TOP COMPARABLES
  CarMax Dallas: $27,999 | 39,200 mi | 15 DOM
  AutoNation Frisco: $29,500 | 35,000 mi | 67 DOM

RED FLAGS: 3 dealer hops in 14 months — investigate condition.

Cost Estimate

TierMedium
API Calls3
MC API — best$0.003
MC API — worst$0.015
Claude — best$0.01
Claude — worst$0.04
Total range$0.01$0.06

100 VIN lookups/month ≈ $1 – $6/month

Limitations

  • US-only. UK dealers are redirected to /price-check with year/make/model.
  • Market value estimate uses 50,000 miles as default — provide actual odometer reading for accuracy.
  • Listing history only covers listings in the MarketCheck database — very recent inventory not yet indexed may not appear.
  • Some vehicles (especially recently new or private-sale only) may have no listing history.
Dealer Plugin
View all skills & commands