| name | vehicle-history |
| description | Retrieve a vehicle history report from a VIN using the CarsXE API. Use this when a user wants to know a car's history — past owners, accidents, title status, odometer readings, or whether it's been in a crash. |
| license | MIT |
| version | 1.0.0 |
| author | CarsXE |
When the user asks about a vehicle's history, past accidents, title status, or ownership:
- Make an HTTP GET request to the CarsXE History API:
GET https://api.carsxe.com/history?key={CARSXE_API_KEY}&vin={VIN}&source=codex_plugin
- Summarize the history report:
- Number of previous owners
- Accident / damage records
- Title status (clean, salvage, rebuilt, lemon)
- Odometer history
- Theft records
- Clearly highlight any red flags (salvage title, accidents, odometer rollback).
- If the API key is missing, tell the user to set the
CARSXE_API_KEY environment variable (see AGENTS.md).