{"openapi":"3.1.0","info":{"title":"Torque API","version":"0.1.0","description":"A fully local DIY car maintenance reference toolkit: maintenance-interval guidance, tire pressure guidance, fluid checks, dashboard warning lights, torque-spec disclaimers, battery troubleshooting, seasonal prep, DIY-vs-professional guidance, and a car-care glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://torque.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/torque/docs"},"termsOfService":"https://connectorbay.com/torque/terms"},"servers":[{"url":"https://torque.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/torque/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/maintenance_schedule_guide":{"post":{"operationId":"maintenance_schedule_guide","summary":"A commonly-recommended interval RANGE for a routine maintenance item — always a broad range to defer","description":"A commonly-recommended interval RANGE for a routine maintenance item — always a broad range to defer\n    to your owner's manual, never a specific number for your vehicle. Use for \"when should I change my oil\",\n    \"how often should I rotate my tires\", \"how long do spark plugs last\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A maintenance item, e.g. oil change, tire rotation, air filter, cabin filter, brake pads, coolant flush, transmission fluid, spark plugs, timing belt. Omit to list all.","title":"Item"}},"title":"maintenance_schedule_guideArguments","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/tire_pressure_info":{"post":{"operationId":"tire_pressure_info","summary":"Where to find your vehicle's CORRECT tire pressure (the driver's door-jamb sticker or owner's","description":"Where to find your vehicle's CORRECT tire pressure (the driver's door-jamb sticker or owner's\n    manual) and why that differs from the number molded into the tire sidewall (which is the tire's maximum\n    pressure, not the recommended one) — plus how and when to check. Use for \"what tire pressure should I\n    use\", \"is the number on my tire the right pressure\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tire_pressure_infoArguments","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/fluid_check_guide":{"post":{"operationId":"fluid_check_guide","summary":"How to check the level and condition of a common vehicle fluid, and what a warning sign looks like","description":"How to check the level and condition of a common vehicle fluid, and what a warning sign looks like\n    (e.g. milky oil, burnt smell, dark brake fluid). Use for \"how do I check my oil\", \"what does bad coolant\n    look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fluid":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A vehicle fluid, e.g. engine oil, coolant, brake fluid, power steering fluid, transmission fluid, washer fluid. Omit to list all.","title":"Fluid"}},"title":"fluid_check_guideArguments","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/warning_light_guide":{"post":{"operationId":"warning_light_guide","summary":"What a common dashboard warning light generally means and how urgently to act — conservatively,","description":"What a common dashboard warning light generally means and how urgently to act — conservatively,\n    erring toward getting it checked promptly rather than assuming it's minor. Use for \"what does the oil\n    light mean\", \"is it safe to drive with the check engine light on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"light_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A dashboard warning light, e.g. check engine, oil pressure, battery, brake, TPMS, coolant temp, ABS. Omit to list all.","title":"Light Name"}},"title":"warning_light_guideArguments","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/torque_spec_disclaimer_lookup":{"post":{"operationId":"torque_spec_disclaimer_lookup","summary":"Explains that torque specs vary by exact make/model/fastener and must come from the vehicle's service","description":"Explains that torque specs vary by exact make/model/fastener and must come from the vehicle's service\n    manual. Gives a broad, commonly-cited ILLUSTRATIVE range only for lug nuts as a general example — never\n    an authoritative number for any real vehicle or fastener. Use for \"what torque for lug nuts\", \"how tight\n    should spark plugs be\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fastener_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A fastener, e.g. lug nuts, spark plugs, oil drain plug, wheel bearing nut, brake caliper bolts. Omit to list all.","title":"Fastener Type"}},"title":"torque_spec_disclaimer_lookupArguments","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/battery_troubleshooting_guide":{"post":{"operationId":"battery_troubleshooting_guide","summary":"Likely cause and a safe next step for a common battery/starting symptom, including basic jump-start","description":"Likely cause and a safe next step for a common battery/starting symptom, including basic jump-start\n    steps and when to call for professional help instead. Use for \"my car won't start, just clicking\",\n    \"battery terminals are corroded\", \"how do I jump start my car\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symptom":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A battery/starting symptom, e.g. slow crank, clicking, dead/no response, corrosion visible, dashboard lights dim. Omit to list all.","title":"Symptom"}},"title":"battery_troubleshooting_guideArguments","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/seasonal_prep_checklist":{"post":{"operationId":"seasonal_prep_checklist","summary":"A general winter or summer vehicle prep checklist (battery check, tire tread/pressure, wiper","description":"A general winter or summer vehicle prep checklist (battery check, tire tread/pressure, wiper\n    fluid/blades, coolant mix for winter, A/C check for summer). Use for \"winter car checklist\", \"what\n    should I check before a summer road trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"winter or summer. Omit to get both.","title":"Season"}},"title":"seasonal_prep_checklistArguments","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/diy_vs_professional_guide":{"post":{"operationId":"diy_vs_professional_guide","summary":"A general difficulty/risk tier for a common maintenance task, and whether it's commonly DIY-friendly","description":"A general difficulty/risk tier for a common maintenance task, and whether it's commonly DIY-friendly\n    or really warrants a professional — brakes and anything requiring safely lifting the vehicle skew toward\n    \"professional.\" Use for \"can I change my own brake pads\", \"is a timing belt a DIY job\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"task":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A maintenance task, e.g. oil change, wiper blades, air filter, battery replacement, brake pads, timing belt, transmission service. Omit to list all.","title":"Task"}},"title":"diy_vs_professional_guideArguments","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/car_care_glossary":{"post":{"operationId":"car_care_glossary","summary":"Definitions of common car-care terms (OEM vs. aftermarket, ft-lb, OBD-II, viscosity/weight, VIN,","description":"Definitions of common car-care terms (OEM vs. aftermarket, ft-lb, OBD-II, viscosity/weight, VIN,\n    interference engine, and more). Use for \"what does OEM mean\", \"what's OBD-II\", \"what does 5W-30 mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up, e.g. OEM, ft-lb, OBD-II, viscosity. Omit to list all.","title":"Term"}},"title":"car_care_glossaryArguments","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}}}}