{"openapi":"3.1.0","info":{"title":"Hazard API","version":"0.1.0","description":"Earthquakes, tsunami statements, hurricanes, GDACS disaster alerts, NASA natural events, volcano report and a near-me summary — natural hazards from the agencies that monitor them.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://hazard.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/hazard/docs"},"termsOfService":"https://connectorbay.com/hazard/terms"},"servers":[{"url":"https://hazard.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/hazard/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/earthquakes":{"post":{"operationId":"earthquakes","summary":"Recent earthquakes near a place or worldwide (USGS): magnitude, location, depth, time with 'ago', distance and","description":"Recent earthquakes near a place or worldwide (USGS): magnitude, location, depth, time with 'ago', distance and\n    direction from the place, PAGER impact alert (green/yellow/orange/red), felt reports, estimated shaking intensity,\n    and tsunami flag. Use for \"earthquakes near Tokyo this week\", \"any big quakes today\", \"was there a quake in\n    California just now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Centre of the search: city or place. Omit for worldwide.","examples":["Tokyo","Los Angeles"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"radius_km":{"default":500,"description":"Search radius around the place.","maximum":5000,"minimum":10,"title":"Radius Km","type":"integer"},"min_magnitude":{"default":2.5,"description":"Minimum magnitude (worldwide default 4.5; near a place 2.5 is sensible).","maximum":10,"minimum":0,"title":"Min Magnitude","type":"number"},"days":{"default":7,"description":"How many days back.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"max_results":{"default":30,"maximum":200,"minimum":1,"title":"Max Results","type":"integer"}},"title":"earthquakesArguments","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/earthquake":{"post":{"operationId":"earthquake","summary":"One earthquake in detail (USGS): magnitude and type, depth, review status, PAGER alert and expected impact, shaking","description":"One earthquake in detail (USGS): magnitude and type, depth, review status, PAGER alert and expected impact, shaking\n    intensity (ShakeMap MMI), Did-You-Feel-It responses, origin quality, tsunami flag and links to the event page,\n    ShakeMap and region info. Use after `earthquakes` when the user asks \"tell me more about that one\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"USGS event id, e.g. 'us7000tiur' (from `earthquakes`).","examples":["us7000tiur"],"title":"Event Id","type":"string"}},"required":["event_id"],"title":"earthquakeArguments","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/significant_earthquakes":{"post":{"operationId":"significant_earthquakes","summary":"USGS's curated list of significant earthquakes for the past day, week or month — chosen for magnitude, felt","description":"USGS's curated list of significant earthquakes for the past day, week or month — chosen for magnitude, felt\n    reports and impact rather than size alone. Use for \"what were the big earthquakes this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"period":{"default":"week","description":"'day', 'week' or 'month'.","examples":["week"],"title":"Period","type":"string"}},"title":"significant_earthquakesArguments","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/tsunami_statements":{"post":{"operationId":"tsunami_statements","summary":"Latest tsunami messages from NOAA's two warning centres — information statements, watches, advisories and","description":"Latest tsunami messages from NOAA's two warning centres — information statements, watches, advisories and\n    warnings — with region, category, preliminary magnitude, issue time and bulletin link. A statement usually means\n    'no tsunami expected'; the category says which. Use for \"is there a tsunami warning\", \"tsunami risk after that\n    quake\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tsunami_statementsArguments","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/tropical_cyclones":{"post":{"operationId":"tropical_cyclones","summary":"Active tropical cyclones in the Atlantic, Eastern and Central Pacific from the National Hurricane Center:","description":"Active tropical cyclones in the Atlantic, Eastern and Central Pacific from the National Hurricane Center:\n    classification (depression/storm/hurricane), Saffir–Simpson category, sustained winds, pressure, position, movement,\n    latest advisory and graphics links, watches/warnings. Use for \"is there a hurricane right now\", \"where is\n    Hurricane X heading\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"tropical_cyclonesArguments","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/disaster_alerts":{"post":{"operationId":"disaster_alerts","summary":"Global disaster alerts from GDACS (EC Joint Research Centre / UN OCHA): floods, tropical cyclones, earthquakes,","description":"Global disaster alerts from GDACS (EC Joint Research Centre / UN OCHA): floods, tropical cyclones, earthquakes,\n    volcanoes, wildfires and droughts with red/orange/green alert level, affected countries, dates, severity and report\n    link. Use for \"what disasters are active in Asia\", \"any red alerts\", \"floods in India right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"alert_level":{"default":"orange","description":"'red', 'orange', 'green' or 'all' (red+orange default).","examples":["red","all"],"title":"Alert Level","type":"string"},"hazard":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter: earthquake, cyclone, flood, volcano, wildfire, drought.","examples":["flood"],"title":"Hazard"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country name.","examples":["India"],"title":"Country"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Rank by distance from a place.","examples":["Manila"],"title":"Place"},"days":{"default":30,"description":"Include events that ended up to N days ago (current events always included).","maximum":365,"minimum":0,"title":"Days","type":"integer"},"max_results":{"default":25,"maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"title":"disaster_alertsArguments","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/natural_events":{"post":{"operationId":"natural_events","summary":"Natural events NASA is tracking from satellites (EONET): wildfires with acreage, severe storms, volcanoes, floods,","description":"Natural events NASA is tracking from satellites (EONET): wildfires with acreage, severe storms, volcanoes, floods,\n    icebergs and sea ice, dust and haze, temperature extremes — currently open, by category and/or near a place, with\n    last-observed position and source links. Use for \"wildfires near Los Angeles\", \"which volcanoes are active\",\n    \"storms NASA is tracking\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"wildfires, severeStorms, volcanoes, floods, seaLakeIce, dustHaze, drought, landslides, snow, tempExtremes, earthquakes, manmade, waterColor.","examples":["wildfires","volcanoes"],"title":"Category"},"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only events within `radius_km` of this place.","examples":["Los Angeles"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"radius_km":{"default":500,"maximum":5000,"minimum":10,"title":"Radius Km","type":"integer"},"days":{"default":30,"description":"Events updated in the last N days.","maximum":365,"minimum":1,"title":"Days","type":"integer"},"max_results":{"default":30,"maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"title":"natural_eventsArguments","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/volcano_report":{"post":{"operationId":"volcano_report","summary":"The Smithsonian Global Volcanism Program / USGS Weekly Volcanic Activity Report: every volcano with notable","description":"The Smithsonian Global Volcanism Program / USGS Weekly Volcanic Activity Report: every volcano with notable\n    activity this week, where it is, and a summary of eruptions, ash plumes, lava flows and alert levels. Use for\n    \"which volcanoes erupted this week\", \"what's Etna doing\", \"volcanic activity in Indonesia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"volcano":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by volcano name or country.","examples":["Etna","Indonesia"],"title":"Volcano"}},"title":"volcano_reportArguments","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/humanitarian_disasters":{"post":{"operationId":"humanitarian_disasters","summary":"Ongoing and alert-status disasters as tracked by UN OCHA's ReliefWeb (humanitarian view: type, countries,","description":"Ongoing and alert-status disasters as tracked by UN OCHA's ReliefWeb (humanitarian view: type, countries,\n    GLIDE number, status, links). Requires the operator to have configured a ReliefWeb appname; otherwise this tool\n    says so and `disaster_alerts` (GDACS) is the alternative.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search, e.g. 'flood', 'cholera', 'cyclone'.","examples":["flood"],"title":"Query"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Country name.","examples":["Bangladesh"],"title":"Country"}},"title":"humanitarian_disastersArguments","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/near_me":{"post":{"operationId":"near_me","summary":"Everything hazardous happening near a place right now, in one call: earthquakes M2.5+ in the last 7 days, GDACS","description":"Everything hazardous happening near a place right now, in one call: earthquakes M2.5+ in the last 7 days, GDACS\n    alerts, NASA-tracked events (fires, storms, volcanoes, floods), tropical cyclones within 1,500 km, and any tsunami\n    watch/warning — each with distance and direction, plus a one-line verdict. Use for \"anything dangerous near\n    Lisbon\", \"is my area affected by anything\", \"situation around Manila\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"place":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"City or place.","examples":["Lisbon","Manila"],"title":"Place"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"type":"null"}],"default":null,"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"type":"null"}],"default":null,"title":"Longitude"},"radius_km":{"default":500,"description":"Radius for earthquakes and events (cyclones use 1,500 km).","maximum":3000,"minimum":50,"title":"Radius Km","type":"integer"}},"title":"near_meArguments","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}}}}