{"openapi":"3.1.0","info":{"title":"Road Trip Kit API","version":"0.1.0","description":"A fully local, hand-curated, platform-agnostic road-trip and overlanding planning reference and toolkit: checklists plus real local calculators for driving-time, fuel stops and trip budget.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://roadtripkit.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/roadtripkit/docs"},"termsOfService":"https://connectorbay.com/roadtripkit/terms"},"servers":[{"url":"https://roadtripkit.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/roadtripkit/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/vehicle_prep_checklist":{"post":{"operationId":"vehicle_prep_checklist","summary":"Pre-trip vehicle checks for a trip type: standard road trip, overlanding/off-pavement, winter/cold-climate,","description":"Pre-trip vehicle checks for a trip type: standard road trip, overlanding/off-pavement, winter/cold-climate,\n    or hot-climate/desert. Use for \"what should I check on my car before a road trip\", \"vehicle prep for an\n    overlanding trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trip_type":{"default":"standard","description":"Trip type.","examples":["standard","overlanding","winter","hot climate"],"title":"Trip Type","type":"string"}},"title":"vehicle_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/route_planning_framework":{"post":{"operationId":"route_planning_framework","summary":"General principles for planning a multi-day route: driving hours per day, buffer days, fuel/food/overnight","description":"General principles for planning a multi-day route: driving hours per day, buffer days, fuel/food/overnight\n    planning, and driver-swap points. Use for \"how should I plan the route for a road trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"route_planning_frameworkArguments","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/packing_checklist":{"post":{"operationId":"packing_checklist","summary":"Base road-trip packing categories (documents, vehicle essentials, comfort, safety) plus additions for a trip","description":"Base road-trip packing categories (documents, vehicle essentials, comfort, safety) plus additions for a trip\n    type and/or climate. Use for \"packing list for an overlanding trip\", \"what should I pack for a winter road trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trip_type":{"default":"standard","description":"Trip type.","examples":["standard","overlanding","camping","winter","hot climate"],"title":"Trip Type","type":"string"},"climate":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional climate to add items for.","examples":["winter","hot climate"],"title":"Climate"}},"title":"packing_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/emergency_kit_checklist":{"post":{"operationId":"emergency_kit_checklist","summary":"What to carry in the vehicle in case of a breakdown or emergency, with optional winter additions. Use for","description":"What to carry in the vehicle in case of a breakdown or emergency, with optional winter additions. Use for\n    \"what should be in my car's emergency kit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"winter":{"default":false,"description":"Include winter-specific additions.","title":"Winter","type":"boolean"}},"title":"emergency_kit_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/overlanding_checklist":{"post":{"operationId":"overlanding_checklist","summary":"Recovery gear, self-sufficiency (fuel/water/communication), and trip-planning items specific to remote or","description":"Recovery gear, self-sufficiency (fuel/water/communication), and trip-planning items specific to remote or\n    off-pavement overlanding travel. Use for \"what extra do I need for an overlanding trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"overlanding_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/campsite_vs_lodging":{"post":{"operationId":"campsite_vs_lodging","summary":"A decision guide comparing camping and paid lodging on a road trip: cost, comfort, flexibility, and how to","description":"A decision guide comparing camping and paid lodging on a road trip: cost, comfort, flexibility, and how to\n    choose. Use for \"should I camp or get a hotel on my road trip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"campsite_vs_lodgingArguments","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/daily_driving_plan":{"post":{"operationId":"daily_driving_plan","summary":"Computes a sustainable-pace route plan: total driving hours, recommended number of days, and distance per","description":"Computes a sustainable-pace route plan: total driving hours, recommended number of days, and distance per\n    day, from total distance and driving-pace assumptions. Use for \"how many days should a 2000 km road trip take\",\n    \"how far can I drive comfortably in a day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"total_distance_km":{"description":"Total route distance in kilometers.","examples":[2000],"exclusiveMinimum":0,"title":"Total Distance Km","type":"number"},"max_hours_per_day":{"default":7.0,"description":"Comfortable maximum driving hours per day.","exclusiveMinimum":0,"maximum":14,"title":"Max Hours Per Day","type":"number"},"avg_speed_kmh":{"default":80.0,"description":"Expected average moving speed in km/h.","exclusiveMinimum":0,"maximum":160,"title":"Avg Speed Kmh","type":"number"},"break_minutes_per_driving_hour":{"default":10.0,"description":"Break minutes taken per hour of driving.","maximum":30,"minimum":0,"title":"Break Minutes Per Driving Hour","type":"number"}},"required":["total_distance_km"],"title":"daily_driving_planArguments","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_stop_plan":{"post":{"operationId":"fuel_stop_plan","summary":"Computes how many fuel stops a route needs given the vehicle's range and a safety margin, and the suggested","description":"Computes how many fuel stops a route needs given the vehicle's range and a safety margin, and the suggested\n    refuel interval. Use for \"how many times will I need to refuel on a 1500 km trip with a 500 km range\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"total_distance_km":{"description":"Total route distance in kilometers.","examples":[1500],"exclusiveMinimum":0,"title":"Total Distance Km","type":"number"},"tank_range_km":{"description":"Vehicle's typical full-tank range in kilometers.","examples":[500],"exclusiveMinimum":0,"title":"Tank Range Km","type":"number"},"safety_margin_pct":{"default":20.0,"description":"Percent of tank range to keep as reserve before refueling.","exclusiveMaximum":100,"minimum":0,"title":"Safety Margin Pct","type":"number"},"starting_fuel_pct":{"default":100.0,"description":"Fuel level at departure, as a percent of a full tank.","exclusiveMinimum":0,"maximum":100,"title":"Starting Fuel Pct","type":"number"}},"required":["total_distance_km","tank_range_km"],"title":"fuel_stop_planArguments","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/trip_budget_estimate":{"post":{"operationId":"trip_budget_estimate","summary":"A rough total-cost estimate for a road trip from fuel, lodging, food and misc inputs. Use for \"estimate the","description":"A rough total-cost estimate for a road trip from fuel, lodging, food and misc inputs. Use for \"estimate the\n    cost of a 5-day road trip covering 1200 km\", \"budget for a road trip with 2 people\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"days":{"description":"Number of trip days.","examples":[5],"maximum":180,"minimum":1,"title":"Days","type":"integer"},"distance_km":{"description":"Total driving distance in kilometers.","examples":[1200],"minimum":0,"title":"Distance Km","type":"number"},"fuel_efficiency_l_per_100km":{"description":"Vehicle efficiency in liters per 100 km.","examples":[8.0],"exclusiveMinimum":0,"title":"Fuel Efficiency L Per 100Km","type":"number"},"fuel_price_per_liter":{"description":"Fuel price per liter, in your currency.","examples":[1.6],"minimum":0,"title":"Fuel Price Per Liter","type":"number"},"lodging_per_night":{"default":0.0,"description":"Lodging cost per night.","minimum":0,"title":"Lodging Per Night","type":"number"},"food_per_person_per_day":{"default":0.0,"description":"Food cost per person per day.","minimum":0,"title":"Food Per Person Per Day","type":"number"},"people":{"default":1,"description":"Number of people sharing the trip.","maximum":20,"minimum":1,"title":"People","type":"integer"},"misc_per_day":{"default":0.0,"description":"Miscellaneous cost per day (tolls, parking, activities).","minimum":0,"title":"Misc Per Day","type":"number"}},"required":["days","distance_km","fuel_efficiency_l_per_100km","fuel_price_per_liter"],"title":"trip_budget_estimateArguments","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/road_trip_glossary":{"post":{"operationId":"road_trip_glossary","summary":"Definitions of common road-trip/overlanding terms — overlanding, recovery gear, approach/departure angle,","description":"Definitions of common road-trip/overlanding terms — overlanding, recovery gear, approach/departure angle,\n    buffer day, personal locator beacon. Use for \"what's overlanding\", \"what's a buffer day\".","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; omit to list all.","title":"Term"}},"title":"road_trip_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}}}}