{"openapi":"3.1.0","info":{"title":"Vault API","version":"0.1.0","description":"A home emergency-preparedness reference and calculator: supply-kit and go-bag checklists, a water-storage calculator, food-storage guidance, per-emergency-type preparedness steps, a documents checklist, a family communication-plan guide, pet-emergency guidance, and a glossary — all local, general reference only, never live alerts.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://vault.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/vault/docs"},"termsOfService":"https://connectorbay.com/vault/terms"},"servers":[{"url":"https://vault.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/vault/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/supply_kit_checklist":{"post":{"operationId":"supply_kit_checklist","summary":"A FEMA/Ready.gov-style disaster supply kit checklist, grouped by category (water & food, communication,","description":"A FEMA/Ready.gov-style disaster supply kit checklist, grouped by category (water & food, communication,\n    light & power, first aid, sanitation, tools & safety, documents & money, household-specific), for a given\n    number of days and optionally scaled to a household size. Use for \"what should be in an emergency kit\",\n    \"build me a 2-week supply list for a family of 5\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"household_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of people to scale water/food/light quantities for; omit for a general, unscaled checklist.","title":"Household Size"},"days":{"default":3,"description":"Number of days the kit should cover.","maximum":365,"minimum":1,"title":"Days","type":"integer"}},"title":"supply_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/water_storage_calculator":{"post":{"operationId":"water_storage_calculator","summary":"Exact water-storage math using the standard planning figure of 1 gallon per person per day (household_size","description":"Exact water-storage math using the standard planning figure of 1 gallon per person per day (household_size\n    x days x 1 gallon), plus context on the 3-day minimum / 2-week-at-home recommendations, who needs more than\n    the baseline, and storage/rotation tips. Use for \"how much water should I store for a family of 4 for a\n    week\", \"how many gallons do I need for 2 weeks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"household_size":{"description":"Number of people to store water for.","maximum":100,"minimum":1,"title":"Household Size","type":"integer"},"days":{"description":"Number of days to store water for.","maximum":365,"minimum":1,"title":"Days","type":"integer"}},"required":["household_size","days"],"title":"water_storage_calculatorArguments","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/food_storage_guide":{"post":{"operationId":"food_storage_guide","summary":"General non-perishable food storage guidance: what to store, how much, rotation ('first in, first out'),","description":"General non-perishable food storage guidance: what to store, how much, rotation ('first in, first out'),\n    storage conditions, and cooking without power. Use for \"how do I rotate my emergency food\", \"how much food\n    should I store per person\", \"can I still cook if the power is out\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"what_to_store | quantities | rotation | storage_conditions | cooking_without_power; omit for an overview of all topics.","title":"Topic"}},"title":"food_storage_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/emergency_type_guide":{"post":{"operationId":"emergency_type_guide","summary":"General before/during/after preparedness steps for one emergency type. This is general preparedness","description":"General before/during/after preparedness steps for one emergency type. This is general preparedness\n    reference, never current/live alerts — every response says so explicitly and points to official real-time\n    sources (local emergency management, NOAA/weather.gov, Ready.gov). Use for \"what should I do before a\n    hurricane\", \"how do I prepare for an earthquake\", \"winter storm safety tips\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"description":"power_outage | winter_storm | hurricane_flood | wildfire | earthquake (aliases like 'blackout', 'blizzard', 'hurricane', 'fire', 'quake' also work).","examples":["power_outage","hurricane","wildfire"],"title":"Type","type":"string"}},"required":["type"],"title":"emergency_type_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/document_checklist":{"post":{"operationId":"document_checklist","summary":"Important documents to have copied and kept accessible — identification, financial & property, medical,","description":"Important documents to have copied and kept accessible — identification, financial & property, medical,\n    household & legal — plus storage tips (fireproof safe, grab-and-go copies, encrypted backup). General\n    organizational guidance, not legal advice. Use for \"what documents should I keep copies of for an\n    emergency\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"document_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/communication_plan_guide":{"post":{"operationId":"communication_plan_guide","summary":"How to build a family emergency communication plan: an out-of-area contact, two meeting places, texting","description":"How to build a family emergency communication plan: an out-of-area contact, two meeting places, texting\n    over calling, written/offline copies, covering school and work, plus a template's fields and practice tips.\n    Use for \"how do I make a family emergency communication plan\", \"what's an out-of-area contact\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"communication_plan_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/go_bag_checklist":{"post":{"operationId":"go_bag_checklist","summary":"A lighter, portable evacuation (\"go bag\" / \"bug-out bag\") checklist — grab-and-go essentials, personal &","description":"A lighter, portable evacuation (\"go bag\" / \"bug-out bag\") checklist — grab-and-go essentials, personal &\n    medical, comfort & extras — optionally scaled to a household size. Use for \"what goes in a go bag\", \"build\n    me an evacuation bag checklist for 3 people\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"household_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of people to scale quantities for; omit for a general, unscaled checklist.","title":"Household Size"}},"title":"go_bag_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/pet_emergency_guide":{"post":{"operationId":"pet_emergency_guide","summary":"General pet-preparedness guidance — kit items (food, water, carrier, records, ID), planning ahead","description":"General pet-preparedness guidance — kit items (food, water, carrier, records, ID), planning ahead\n    (pet-friendly shelters/hotels, a backup caretaker list), and evacuating with pets. Genuinely often\n    overlooked. Use for \"how do I prepare my pets for an emergency\", \"what goes in a pet emergency kit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"pet_emergency_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/preparedness_glossary":{"post":{"operationId":"preparedness_glossary","summary":"Definitions of common emergency-preparedness terms (go bag, shelter in place, out-of-area contact,","description":"Definitions of common emergency-preparedness terms (go bag, shelter in place, out-of-area contact,\n    defensible space, drop-cover-hold-on, storm surge, and more). Use for \"what does shelter in place mean\",\n    \"what is defensible space\".","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":"preparedness_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}}}}