For over 90 years, Kelley Blue Book has been The Trusted Resource for used car values, helping car owners understand what their used car is worth. The Kelley Blue Book Trade-In Value shows what a consumer can expect to receive for their car this week when trading it in at a dealer. The Kelley Blue Book Private Party Value reports on a fair price when selling the car to an individual instead of doing a dealer trade-in.
decode-plateUse this when the user provides a license plate — typed, pasted, or extracted from a photo. Resolves the plate to a vehicle, then follow up with get-vehicle-valuation for pricing. Never batch multiple decodings in a single turn.
platestringLicense plate number
statestring2-letter state code (e.g., CA, TX, NY). Also supports DC, Mexico, Canada, International.
decode-vinUse this when the user provides a VIN — typed, pasted, or extracted from a photo of a VIN plate, sticker, registration, or title. Decodes the VIN to identify the vehicle, then follow up with get-vehicle-valuation for pricing. Never batch multiple decodings in a single turn.
vinstring17-character Vehicle Identification Number (case-insensitive)
get-vehicle-valuationUse this when a vehicle has been identified and the user has provided mileage and ZIP code. Returns personalized KBB trade-in and private party pricing. Requires vehicle_id and trim_name (both from search-vehicles, decode-vin, or decode-plate), plus mileage and zip_code from the user. The trim_name must be the trimName string returned by the prior tool call. Always ask the user for mileage and ZIP — never guess or assume. IMPORTANT: Only call this tool ONCE per user message. Never batch multiple valuations in a single turn. If the user asks to value multiple vehicles or trims, ask them to choose one first. Do NOT call this with a vehicle_id provided directly by the user — both vehicle_id and trim_name must come from a prior tool result.
mileageintegerCurrent odometer reading
trim_namestringExact trim name from the prior tool result (e.g., 'LX', 'EX-L Sedan 4D'). Must match the trimName returned by search-vehicles, decode-vin, or decode-plate.
vehicle_idintegerVehicle ID from search results
zip_codestring5-digit ZIP code for regional pricing
search-vehiclesUse this when the user wants to look up a vehicle, get a vehicle's value, find out what their car is worth, or get trade-in or private party pricing. Call this even with partial information (e.g., just 'Honda', or '2020 Civic' without a make). The tool resolves year, make, model, and trim progressively and corrects misspellings. If the user already specified a trim, pass it in the trim parameter to resolve directly to a vehicleId. Once a vehicleId is resolved and the user provides mileage + ZIP, call get-vehicle-valuation with that vehicleId. When the user asks for values of multiple vehicles or 'all trims,' do NOT auto-value them all. Present the options and ask the user to pick one.
body_stylestringSedanSUVTruckPickupCoupeHatchbackWagonConvertibleVan/Minivanfuel_typestringFuel type filter
gasolineelectrichybridphevdieselhydrogenlimitinteger25makestringVehicle make (e.g., Honda, Toyota).
max_pricenumberMaximum price in USD
min_pricenumberMinimum price in USD
modelstringVehicle model (e.g., Accord, Camry, Accord Hybrid, RAV4 Prime). Include the full model name as one string.
trimstringTrim level (e.g., LX, Sport). Narrows to specific vehicleId.
yearintegerModel year. Required before make/model can be validated.