{"openapi":"3.1.0","info":{"title":"Garage API","version":"0.1.0","description":"The car you own or want to buy: VIN decode, recalls, complaints, NHTSA ratings, EPA fuel economy, comparison and a used-car check.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://garage.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/garage/docs"},"termsOfService":"https://connectorbay.com/garage/terms"},"servers":[{"url":"https://garage.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/garage/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/decode_vin":{"post":{"operationId":"decode_vin","summary":"What a VIN is: year, make, model, trim, body, engine and horsepower, fuel, drivetrain, transmission, plant, and the","description":"What a VIN is: year, make, model, trim, body, engine and horsepower, fuel, drivetrain, transmission, plant, and the\n    safety equipment built in (airbags, ESC, forward-collision warning, automatic braking, blind-spot, backup camera), plus a\n    check-digit validity test. Use for \"what car is this\", \"decode this VIN\", \"does this VIN look right\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"description":"17-character VIN.","examples":["1HGCV1F34LA123456"],"title":"Vin","type":"string"}},"required":["vin"],"title":"decode_vinArguments","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/recalls":{"post":{"operationId":"recalls","summary":"Open safety recalls for a vehicle (by VIN or year/make/model): each campaign's component, the defect, the risk, the","description":"Open safety recalls for a vehicle (by VIN or year/make/model): each campaign's component, the defect, the risk, the\n    free remedy, and NHTSA's park-it / park-outside flags, sorted with the most urgent first, plus what to do next. Use for\n    \"any recalls on my car\", \"is this recall fixed\", \"should I stop driving it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN (from the door jamb, dashboard, registration or insurance card).","examples":["1HGCV1F34LA123456"],"title":"Vin"},"year":{"anyOf":[{"maximum":2028,"minimum":1981,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, if not giving a VIN.","title":"Year"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, if not giving a VIN: 'Honda', 'Toyota', 'Ford'.","examples":["Honda"],"title":"Make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model, if not giving a VIN: 'Accord', 'RAV4', 'F-150'.","examples":["Accord"],"title":"Model"}},"title":"recallsArguments","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/complaints":{"post":{"operationId":"complaints","summary":"Owner complaints filed with NHTSA for a vehicle: the total, the components most complained about, crash/fire/injury","description":"Owner complaints filed with NHTSA for a vehicle: the total, the components most complained about, crash/fire/injury\n    counts, and recent examples — the fastest read on a model year's known problems. Use for \"what goes wrong with a 2018\n    Equinox\", \"are the transmission complaints real\", \"known issues before I buy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN (from the door jamb, dashboard, registration or insurance card).","examples":["1HGCV1F34LA123456"],"title":"Vin"},"year":{"anyOf":[{"maximum":2028,"minimum":1981,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, if not giving a VIN.","title":"Year"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, if not giving a VIN: 'Honda', 'Toyota', 'Ford'.","examples":["Honda"],"title":"Make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model, if not giving a VIN: 'Accord', 'RAV4', 'F-150'.","examples":["Accord"],"title":"Model"},"component":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter to a component keyword, e.g. 'transmission', 'engine', 'brakes', 'electrical'.","title":"Component"}},"title":"complaintsArguments","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/safety_ratings":{"post":{"operationId":"safety_ratings","summary":"NHTSA 5-Star crash-test ratings for a vehicle: overall, frontal (driver/passenger), side (barrier/pole), rollover with","description":"NHTSA 5-Star crash-test ratings for a vehicle: overall, frontal (driver/passenger), side (barrier/pole), rollover with\n    the rollover risk percentage, per variant (FWD/AWD, body style), plus which recommended safety technologies it has. Use\n    for \"how safe is the 2022 Highlander\", \"crash rating for this car\", \"5-star rating\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN (from the door jamb, dashboard, registration or insurance card).","examples":["1HGCV1F34LA123456"],"title":"Vin"},"year":{"anyOf":[{"maximum":2028,"minimum":1981,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, if not giving a VIN.","title":"Year"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, if not giving a VIN: 'Honda', 'Toyota', 'Ford'.","examples":["Honda"],"title":"Make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model, if not giving a VIN: 'Accord', 'RAV4', 'F-150'.","examples":["Accord"],"title":"Model"}},"title":"safety_ratingsArguments","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/fuel_economy":{"post":{"operationId":"fuel_economy","summary":"EPA fuel economy for a vehicle: city/highway/combined MPG (or MPGe, range and charge time for EVs and plug-ins), annual","description":"EPA fuel economy for a vehicle: city/highway/combined MPG (or MPGe, range and charge time for EVs and plug-ins), annual\n    fuel cost at the person's own miles and price, CO2 per mile, and every engine/transmission option so the right one can\n    be picked. Use for \"what MPG does it get\", \"how much gas per year\", \"is the hybrid worth it\", \"EV range\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN (from the door jamb, dashboard, registration or insurance card).","examples":["1HGCV1F34LA123456"],"title":"Vin"},"year":{"anyOf":[{"maximum":2028,"minimum":1981,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, if not giving a VIN.","title":"Year"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, if not giving a VIN: 'Honda', 'Toyota', 'Ford'.","examples":["Honda"],"title":"Make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model, if not giving a VIN: 'Accord', 'RAV4', 'F-150'.","examples":["Accord"],"title":"Model"},"miles_per_year":{"default":12000,"description":"Annual miles for the cost estimate.","maximum":100000,"minimum":1000,"title":"Miles Per Year","type":"integer"},"fuel_price_usd":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Price per gallon (or per kWh for EVs) to use; EPA's default assumptions when omitted.","title":"Fuel Price Usd"}},"title":"fuel_economyArguments","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/compare_vehicles":{"post":{"operationId":"compare_vehicles","summary":"Side by side for two to four vehicles: NHTSA overall stars, rollover risk, open recall count (with any park-it), complai","description":"Side by side for two to four vehicles: NHTSA overall stars, rollover risk, open recall count (with any park-it), complaint\n    count, and EPA combined MPG / annual fuel cost — with who wins on each. Use for \"CR-V or RAV4\", \"which of these is safest\",\n    \"compare these three used SUVs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vehicles":{"description":"2–4 vehicles as 'year make model', e.g. ['2022 Honda CR-V', '2022 Toyota RAV4'].","examples":[["2022 Honda CR-V","2022 Toyota RAV4","2022 Mazda CX-5"]],"items":{"type":"string"},"maxItems":4,"minItems":2,"title":"Vehicles","type":"array"}},"required":["vehicles"],"title":"compare_vehiclesArguments","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/used_car_check":{"post":{"operationId":"used_car_check","summary":"One call before buying or when something feels off with your own car: decode (if VIN), open recalls with urgency,","description":"One call before buying or when something feels off with your own car: decode (if VIN), open recalls with urgency,\n    complaint profile and top problem areas, crash ratings, fuel economy and cost — assembled into a plain-English verdict\n    with the questions to ask the seller and the next step. Use for \"should I buy this 2019 Rogue\", \"what should I know about\n    this VIN\", \"is this car a good idea\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"17-character VIN (from the door jamb, dashboard, registration or insurance card).","examples":["1HGCV1F34LA123456"],"title":"Vin"},"year":{"anyOf":[{"maximum":2028,"minimum":1981,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, if not giving a VIN.","title":"Year"},"make":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Make, if not giving a VIN: 'Honda', 'Toyota', 'Ford'.","examples":["Honda"],"title":"Make"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Model, if not giving a VIN: 'Accord', 'RAV4', 'F-150'.","examples":["Accord"],"title":"Model"},"asking_price_usd":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Asking price, if known (only echoed into the summary).","title":"Asking Price Usd"}},"title":"used_car_checkArguments","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/models_for_make":{"post":{"operationId":"models_for_make","summary":"The model names NHTSA uses for a make and year, so the other tools get the exact spelling ('Grand Cherokee', 'F-150',","description":"The model names NHTSA uses for a make and year, so the other tools get the exact spelling ('Grand Cherokee', 'F-150',\n    'Model 3'). Use when a lookup returns nothing or the person is unsure of the model name.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"description":"Make, e.g. 'Toyota'.","examples":["Toyota"],"title":"Make","type":"string"},"year":{"description":"Model year.","maximum":2028,"minimum":1981,"title":"Year","type":"integer"}},"required":["make","year"],"title":"models_for_makeArguments","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}}}}