{"openapi":"3.1.0","info":{"title":"Helm API","version":"0.1.0","description":"A fully local recreational boating & sailing reference: simplified COLREGs give-way basics, points of sail, distress signals (including VHF Channel 16), a safety-equipment checklist, a boating knot subset, docking basics, weather reading, a glossary and a pre-departure checklist.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://helm.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/helm/docs"},"termsOfService":"https://connectorbay.com/helm/terms"},"servers":[{"url":"https://helm.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/helm/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/navigation_rules_overview":{"post":{"operationId":"navigation_rules_overview","summary":"Simplified COLREGs (International Regulations for Preventing Collisions at Sea) give-way basics: power","description":"Simplified COLREGs (International Regulations for Preventing Collisions at Sea) give-way basics: power\n    vs. sail, the overtaking vessel always gives way, port-vs-starboard crossing rules, and head-on meetings.\n    Explicitly general safety education, NOT a substitute for an official boating safety course or your\n    jurisdiction's operator licensing requirements. Use for \"who has the right of way, a sailboat or a\n    motorboat\", \"what happens when two boats are crossing paths\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"navigation_rules_overviewArguments","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/points_of_sail_guide":{"post":{"operationId":"points_of_sail_guide","summary":"The standard points-of-sail diagram described in words: in irons (the no-go zone), close-hauled, close","description":"The standard points-of-sail diagram described in words: in irons (the no-go zone), close-hauled, close\n    reach, beam reach, broad reach, and running, each with the wind angle and what it feels like to sail. Use\n    for \"what's a beam reach\", \"what does close-hauled mean\", \"why can't I sail straight into the wind\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"points_of_sail_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/distress_signal_guide":{"post":{"operationId":"distress_signal_guide","summary":"Overview of internationally recognized distress signals: visual (red flares, orange smoke, raised arms,","description":"Overview of internationally recognized distress signals: visual (red flares, orange smoke, raised arms,\n    SOS), sound (continuous fog-signal, a gun at one-minute intervals), and VHF radio (the Mayday procedure on\n    Channel 16, the internationally designated calling/hailing/distress channel). Use for \"how do I call\n    Mayday\", \"what channel do I use for a marine emergency\", \"what are the distress flare colors\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"distress_signal_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/safety_equipment_checklist":{"post":{"operationId":"safety_equipment_checklist","summary":"A general recreational-boating safety equipment checklist: PFDs/life jackets, fire extinguisher, visual","description":"A general recreational-boating safety equipment checklist: PFDs/life jackets, fire extinguisher, visual\n    distress signals, sound-producing device, navigation lights, first aid kit, anchor, bilge pump, VHF radio,\n    and a float plan. Requirements vary by boat size, type and jurisdiction -- this is general awareness, not a\n    compliance guarantee. Use for \"what safety gear do I need on my boat\", \"what do I need for a sailboat vs a\n    jet ski\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"boat_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"sailboat | powerboat | personal_watercraft | paddle_craft; omit for the general checklist only.","title":"Boat Type"}},"title":"safety_equipment_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/knot_guide":{"post":{"operationId":"knot_guide","summary":"A boating-specific subset of four essential knots (bowline, cleat hitch, clove hitch, figure-eight","description":"A boating-specific subset of four essential knots (bowline, cleat hitch, clove hitch, figure-eight\n    stopper) with step-by-step instructions and typical on-the-water uses. For the full 44-knot reference\n    across climbing, camping, fishing, decorative, household and rescue knots, see the sibling Knots connector.\n    Use for \"how do I tie a bowline\", \"what knot do I use to secure a dock line\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific knot: bowline, cleat_hitch, clove_hitch, or figure_eight_stopper. Omit to list all four.","title":"Name"}},"title":"knot_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/docking_basics_guide":{"post":{"operationId":"docking_basics_guide","summary":"General, introductory docking principles: approach angle, using wind and current, fender placement, and","description":"General, introductory docking principles: approach angle, using wind and current, fender placement, and\n    line handling. Not a substitute for hands-on instruction with your own boat. Use for \"how do I dock in a\n    crosswind\", \"what fenders and lines do I need to dock\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"docking_basics_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/weather_reading_guide":{"post":{"operationId":"weather_reading_guide","summary":"General signs of changing weather on the water: darkening/building clouds, a sudden wind shift, dropping","description":"General signs of changing weather on the water: darkening/building clouds, a sudden wind shift, dropping\n    barometric pressure, a sudden calm, a sun/moon halo, and distant thunder. General awareness only --\n    recommends checking an actual marine forecast before departure. Use for \"what are signs bad weather is\n    coming while I'm out on the water\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"weather_reading_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/terminology_glossary":{"post":{"operationId":"terminology_glossary","summary":"Definitions of common boating and sailing terms (port, starboard, bow, stern, beam, draft, windward,","description":"Definitions of common boating and sailing terms (port, starboard, bow, stern, beam, draft, windward,\n    leeward, tack, jibe, helm, hull, keel, ...). Use for \"what does leeward mean\", \"what's the difference\n    between tacking and jibing\".","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":"terminology_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}},"/v1/tools/pre_departure_checklist":{"post":{"operationId":"pre_departure_checklist","summary":"A general pre-departure safety checklist: file a float plan, check the weather forecast, check fuel and","description":"A general pre-departure safety checklist: file a float plan, check the weather forecast, check fuel and\n    fluids, confirm safety equipment is aboard and accessible, check navigation lights and electronics, check\n    the bilge, brief everyone aboard, and secure loose gear. Use for \"what should I check before I leave the\n    dock\", \"pre-departure boat checklist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pre_departure_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}}}}