{"openapi":"3.1.0","info":{"title":"Splint API","version":"0.1.0","description":"A basic first-aid reference connector: emergency first steps, minor wound care, choking-response and CPR overviews, burn care, sprain/strain (RICE), allergic-reaction awareness, heat-illness distinction, and a first-aid-kit checklist — all local, general first-aid education only, never a substitute for professional medical care, certified training, or calling emergency services.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://splint.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/splint/docs"},"termsOfService":"https://connectorbay.com/splint/terms"},"servers":[{"url":"https://splint.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/splint/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/emergency_first_steps":{"post":{"operationId":"emergency_first_steps","summary":"What to do right away for a serious first-aid situation. Every response leads with calling emergency","description":"What to do right away for a serious first-aid situation. Every response leads with calling emergency\n    services immediately, before any other content, followed by general first-aid-education steps verified\n    against Red Cross/Mayo Clinic sources. This is education only — it never diagnoses and is never a\n    substitute for calling 911 or for professional medical care. Use for \"someone is choking\", \"severe\n    bleeding won't stop\", \"possible heart attack\", \"signs of a severe allergic reaction\", \"person is\n    unresponsive\", \"having a seizure\", \"heat stroke symptoms\", \"swallowed something toxic\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"situation":{"description":"The situation: choking | severe_bleeding | chest_pain | anaphylaxis | unconsciousness | seizure | heat_stroke | poisoning (natural-language phrasing also works).","examples":["choking","severe bleeding","chest pain","anaphylaxis"],"title":"Situation","type":"string"}},"required":["situation"],"title":"emergency_first_stepsArguments","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/wound_care_basics_guide":{"post":{"operationId":"wound_care_basics_guide","summary":"General first-aid steps for MINOR cuts and scrapes only: clean hands, control bleeding, rinse and","description":"General first-aid steps for MINOR cuts and scrapes only: clean hands, control bleeding, rinse and\n    clean the wound, apply ointment, bandage, and watch for infection — with an explicit list of when to seek\n    professional or emergency care instead (deep wounds, heavy bleeding, embedded objects, bites, signs of\n    infection). Use for \"how do I clean a scrape\", \"minor cut first aid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"wound_care_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/choking_response_overview":{"post":{"operationId":"choking_response_overview","summary":"A general educational overview of the choking-response (Heimlich maneuver / back blows and abdominal","description":"A general educational overview of the choking-response (Heimlich maneuver / back blows and abdominal\n    thrusts) concept as commonly taught by the Red Cross. This is educational only — not a substitute for\n    certified hands-on first-aid training — and it says to call 911 immediately if the person can't breathe,\n    can't cough, or is losing consciousness. Use for \"what's the Heimlich maneuver\", \"someone is choking what\n    do I do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"choking_response_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/cpr_overview":{"post":{"operationId":"cpr_overview","summary":"A general educational overview of hands-only adult CPR concepts (compression rate and depth) verified","description":"A general educational overview of hands-only adult CPR concepts (compression rate and depth) verified\n    against American Heart Association guidance. This is not a substitute for certified CPR training, and it\n    says to call 911 first, before starting compressions. Use for \"how do I do CPR\", \"CPR compression rate\n    and depth\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"cpr_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/burn_care_guide":{"post":{"operationId":"burn_care_guide","summary":"The first/second/third-degree burn distinction (skin layers affected, appearance) and basic first-aid","description":"The first/second/third-degree burn distinction (skin layers affected, appearance) and basic first-aid\n    care for MINOR burns only, plus an explicit list of when a burn needs emergency/professional care\n    (third-degree, large, on sensitive areas, chemical/electrical, with smoke inhalation, etc.). Use for \"is\n    this a first or second degree burn\", \"how do I treat a minor burn\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"degree":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"first | second | third (1st/2nd/3rd also accepted); omit for all three.","title":"Degree"}},"title":"burn_care_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/sprain_strain_guide":{"post":{"operationId":"sprain_strain_guide","summary":"The RICE method (Rest, Ice, Compression, Elevation) for a suspected sprain or strain, verified against","description":"The RICE method (Rest, Ice, Compression, Elevation) for a suspected sprain or strain, verified against\n    Mayo Clinic guidance, plus signs that mean it needs professional evaluation instead (unstable/numb joint,\n    pain over a bone, no improvement in 2-3 days). Use for \"how do I treat a sprained ankle\", \"what is\n    RICE\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"sprain_strain_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/allergic_reaction_guide":{"post":{"operationId":"allergic_reaction_guide","summary":"Anaphylaxis (severe allergic reaction) awareness: warning signs and general response. Always says to","description":"Anaphylaxis (severe allergic reaction) awareness: warning signs and general response. Always says to\n    call 911 immediately as the first step; never names a specific medication or dose — it only describes the\n    general concept of a person's own prescribed epinephrine auto-injector (e.g. an EpiPen) being used per its\n    own instructions. This does not diagnose. Use for \"signs of anaphylaxis\", \"severe allergic reaction what\n    to do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"allergic_reaction_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/heat_illness_guide":{"post":{"operationId":"heat_illness_guide","summary":"The distinction between heat exhaustion (symptoms, general first aid) and heat stroke (a medical","description":"The distinction between heat exhaustion (symptoms, general first aid) and heat stroke (a medical\n    emergency — call 911 immediately), verified against Mayo Clinic guidance, plus how heat exhaustion can\n    progress into heat stroke. Use for \"heat exhaustion vs heat stroke\", \"signs of heat stroke\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"heat_illness_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/first_aid_kit_checklist":{"post":{"operationId":"first_aid_kit_checklist","summary":"A general Red-Cross-style basic first-aid kit contents checklist, grouped by category (wound care,","description":"A general Red-Cross-style basic first-aid kit contents checklist, grouped by category (wound care,\n    tools, emergency & CPR, personal & household-specific). A general starting point, not a personalized\n    medical recommendation. Use for \"what should be in a first aid kit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"first_aid_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}}}}