{"openapi":"3.1.0","info":{"title":"EVCompare API","version":"0.1.0","description":"A fully local, brand-neutral EV-vs-gas total-cost-of-ownership and break-even-mileage calculator toolkit, computed from user-supplied vehicle specs. Estimates only, not a purchase recommendation.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://evcompare.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/evcompare/docs"},"termsOfService":"https://connectorbay.com/evcompare/terms"},"servers":[{"url":"https://evcompare.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/evcompare/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/ev_gas_tco_calculator":{"post":{"operationId":"ev_gas_tco_calculator","summary":"Real total-cost-of-ownership math for a user-specified EV vs. a user-specified gas car: purchase price","description":"Real total-cost-of-ownership math for a user-specified EV vs. a user-specified gas car: purchase price\n    + (fuel/energy cost + maintenance cost) x total miles, over the given years and annual mileage. Returns\n    each vehicle's full cost breakdown, which is cheaper overall, and the savings. Brand-neutral — takes specs,\n    never a vehicle name. Use for \"compare TCO of my EV and my gas car over 8 years at 12,000 miles/year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ev_price":{"description":"The EV's purchase price, in dollars.","exclusiveMinimum":0,"title":"Ev Price","type":"number"},"ev_efficiency_kwh_per_100mi":{"description":"The EV's efficiency, in kWh per 100 miles.","exclusiveMinimum":0,"title":"Ev Efficiency Kwh Per 100Mi","type":"number"},"electricity_rate_per_kwh":{"description":"Your electricity rate, in dollars per kWh.","exclusiveMinimum":0,"title":"Electricity Rate Per Kwh","type":"number"},"gas_price_car":{"description":"The gas car's purchase price, in dollars.","exclusiveMinimum":0,"title":"Gas Price Car","type":"number"},"gas_mpg":{"description":"The gas car's fuel economy, in miles per gallon.","exclusiveMinimum":0,"title":"Gas Mpg","type":"number"},"gas_price_per_gallon":{"description":"Local gas price, in dollars per gallon.","exclusiveMinimum":0,"title":"Gas Price Per Gallon","type":"number"},"annual_miles":{"description":"Expected miles driven per year.","exclusiveMinimum":0,"title":"Annual Miles","type":"number"},"years":{"description":"Number of years to compare over.","exclusiveMinimum":0,"maximum":40,"title":"Years","type":"number"},"ev_maintenance_cost_per_mile":{"default":0.06,"description":"Override for EV maintenance cost per mile. Default 0.06.","minimum":0,"title":"Ev Maintenance Cost Per Mile","type":"number"},"gas_maintenance_cost_per_mile":{"default":0.1,"description":"Override for gas-car maintenance cost per mile. Default 0.1.","minimum":0,"title":"Gas Maintenance Cost Per Mile","type":"number"}},"required":["ev_price","ev_efficiency_kwh_per_100mi","electricity_rate_per_kwh","gas_price_car","gas_mpg","gas_price_per_gallon","annual_miles","years"],"title":"ev_gas_tco_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/ev_gas_breakeven_mileage":{"post":{"operationId":"ev_gas_breakeven_mileage","summary":"At what mileage does a higher EV purchase price get offset by its lower running cost per mile —","description":"At what mileage does a higher EV purchase price get offset by its lower running cost per mile —\n    breakeven_miles = price premium / per-mile savings. Also reports if the EV is ahead immediately (cheaper\n    both to buy and to run) or never breaks even (pricier to buy and not cheaper to run). Brand-neutral — takes\n    specs, never a vehicle name. Use for \"at what mileage does a $10,000 pricier EV pay for itself\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ev_price":{"description":"The EV's purchase price, in dollars.","exclusiveMinimum":0,"title":"Ev Price","type":"number"},"gas_price_car":{"description":"The gas car's purchase price, in dollars.","exclusiveMinimum":0,"title":"Gas Price Car","type":"number"},"ev_efficiency_kwh_per_100mi":{"description":"The EV's efficiency, in kWh per 100 miles.","exclusiveMinimum":0,"title":"Ev Efficiency Kwh Per 100Mi","type":"number"},"electricity_rate_per_kwh":{"description":"Your electricity rate, in dollars per kWh.","exclusiveMinimum":0,"title":"Electricity Rate Per Kwh","type":"number"},"gas_mpg":{"description":"The gas car's fuel economy, in miles per gallon.","exclusiveMinimum":0,"title":"Gas Mpg","type":"number"},"gas_price_per_gallon":{"description":"Local gas price, in dollars per gallon.","exclusiveMinimum":0,"title":"Gas Price Per Gallon","type":"number"},"ev_maintenance_cost_per_mile":{"default":0.06,"description":"Override for EV maintenance cost per mile. Default 0.06.","minimum":0,"title":"Ev Maintenance Cost Per Mile","type":"number"},"gas_maintenance_cost_per_mile":{"default":0.1,"description":"Override for gas-car maintenance cost per mile. Default 0.1.","minimum":0,"title":"Gas Maintenance Cost Per Mile","type":"number"}},"required":["ev_price","gas_price_car","ev_efficiency_kwh_per_100mi","electricity_rate_per_kwh","gas_mpg","gas_price_per_gallon"],"title":"ev_gas_breakeven_mileageArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}