Kelley Blue Book

Use 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.

decode-plate

Use 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.

decode-vin

Use 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.

get-vehicle-valuation

Use 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.

search-vehicles