decode_vin
Decode a Vehicle Identification Number (VIN) to get vehicle details.
Returns make, model, year, body class, engine info, safety features,
and other attributes encoded in the 17-character VIN.
Args:
vin: A 17-character Vehicle Identification Number (e.g. '1HGBH41JXMN109186').
get_recalls
Get vehicle safety recalls from NHTSA.
Search for recalls by make, model, and/or year. Returns recall campaigns
including the defect description, remedy, and affected vehicles.
At least one filter (make, model, or year) should be provided.
Args:
make: Vehicle manufacturer name (e.g. 'Toyota', 'Ford', 'Honda').
model: Vehicle model name (e.g. 'Camry', 'F-150', 'Civic').
year: Model year (e.g. 2023).
get_complaints
Get consumer complaints about vehicles filed with NHTSA.
Search for safety complaints by make, model, and/or year. Returns
complaint descriptions, components involved, and crash/injury data.
At least one filter (make, model, or year) should be provided.
Args:
make: Vehicle manufacturer name (e.g. 'Toyota', 'Ford').
model: Vehicle model name (e.g. 'Camry', 'F-150').
year: Model year (e.g. 2023).
limit: Maximum number of complaints to return (default 25).
get_crash_statistics
Get fatal crash statistics from the NHTSA Fatality Analysis Reporting System (FARS).
Returns fatal motor vehicle crash data for a state, including total
fatalities, fatalities by person type (drivers, passengers, pedestrians),
and alcohol-involved crashes.
Args:
state: Two-digit state FIPS code (e.g. '06' for California, '48' for Texas)
or two-letter state abbreviation (e.g. 'CA', 'TX').
year: Year for statistics (e.g. 2022). Defaults to the most recent available year.
complaint_trends_by_component
Get complaint counts by vehicle component for a specific make/model/year.
Shows which parts of the vehicle consumers report the most problems with
(e.g. brakes, engine, electrical system). Useful for identifying systemic
vehicle defect patterns.
Args:
make: Vehicle manufacturer name (e.g. 'Toyota', 'Ford').
model: Vehicle model name (e.g. 'Camry', 'F-150').
year: Model year (e.g. 2023).
local_vehicle_safety_profile
Get a vehicle safety profile using national complaint and recall trends.
NHTSA complaints are not geocoded by state, so this returns national-level
trends as context for local community safety assessments. Includes the most
recent recalls and top complained-about vehicle makes.
Args:
state: Two-letter state abbreviation (e.g. 'CA', 'TX'). Used for crash
statistics; complaint data is national.