| name | market-value |
| description | Get the current market value of a vehicle from its VIN using the CarsXE API. Use this when a user asks how much a car is worth, wants to know its value, or is thinking about buying/selling a vehicle. |
| license | MIT |
| version | 1.0.0 |
| author | CarsXE |
When the user asks about a vehicle's price, worth, or market value and has a VIN:
- Optionally refine the estimate with these parameters if the user mentions them:
state — US state code (e.g., CA, TX) for regional pricingmileage — current mileage to adjust the valuecondition — vehicle condition: excellent, clean, average, or rough
- Make an HTTP GET request to the CarsXE Market Value API:
GET https://api.carsxe.com/v2/marketvalue?key={CARSXE_API_KEY}&vin={VIN}&source=codex_plugin
Append &state=<STATE>, &mileage=<MILEAGE>, and/or &condition=<CONDITION> if provided.
- Present the estimated market value clearly, including:
- Current value estimate
- Low / average / high range if available
- Historical trend if available
- Provide helpful context (e.g., whether the value is strong for its age/mileage).
- If the API key is missing, tell the user to set the
CARSXE_API_KEY environment variable (see AGENTS.md).
