Use the fueleconomy.gov Web Services API to populate a year, make, and model vehicle picker and retrieve official EPA fuel economy ratings for the selected vehicle
domain: fueleconomy.gov · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call the vehicle menu endpoints in sequence, retrieving available years, then makes for a selected year, then models for a selected make and year, to drive a cascading vehicle picker
Call the options menu endpoint when a single make and model maps to multiple trims or configurations, so the user can select the exact vehicle variant
Retrieve the full vehicle record for the selected option ID to get combined, city, and highway MPG figures
Parse the response in the XML format the service returns by default, or convert it as needed for your application
Cache menu and vehicle record responses locally where appropriate, since the underlying EPA dataset only updates with new model years rather than continuously
Known gotchas
The service organizes vehicles by year, make, model, and then option ID rather than by VIN, so you cannot query it directly with a VIN without first decoding the VIN into year, make, and model elsewhere
Responses are XML by default; confirm current format options before assuming a JSON response without adjusting your request or parser
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?