{"openapi":"3.0.3","info":{"title":"Gnist Context — Crisis Intelligence","description":"Unified crisis monitoring combining GDACS disaster alerts (earthquakes, floods, cyclones, volcanoes, droughts, wildfires) with GDELT global news coverage.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/crisis-intelligence/`\n- **Toolkit page:** `/toolkits/crisis-intelligence`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/crisis-intelligence/search_crises":{"post":{"tags":["Government"],"summary":"search_crises","description":"Search for crises combining GDACS disaster alerts, USGS earthquakes, NOAA weather alerts, and GDELT news.\n\nReturns structured disaster events, seismic data, active weather alerts, and\nrelated news articles from global media. All eight sources are queried in parallel\nfor fast response.\n\nSources:\n- GDACS: UN/EU disaster alerts (earthquakes, floods, cyclones, volcanoes, droughts, wildfires)\n- USGS: Real-time seismic events with magnitude, depth, and location\n- NOAA NWS: Active US weather alerts (severe storms, floods, fire weather)\n- NVE: Norwegian flood warnings with regional activity levels\n- SMHI: Swedish weather warnings (fire risk, storms, floods, extreme weather)\n- DMI: Danish weather warnings (storms, rain, wind, snow, fog, ice)\n- FMI: Finnish weather warnings via MeteoAlarm (fire risk, storms, wind, rain, flooding)\n- GDELT: Global news media coverage and sentiment\n\nExamples:\n    search_crises(query=\"earthquake\")\n    search_crises(query=\"flood\", country=\"Bangladesh\", alert_levels=\"Orange,Red\")\n    search_crises(query=\"wildfire California\", event_types=\"WF\", news_timespan=\"24h\")","operationId":"crisis_intelligence_search_crises","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search term — crisis type, country, or topic (e.g. 'earthquake Turkey', 'flood Bangladesh').","type":"string"},"from_date":{"default":"","description":"Start date (YYYY-MM-DD). Defaults to 90 days ago.","type":"string"},"to_date":{"default":"","description":"End date (YYYY-MM-DD). Defaults to today.","type":"string"},"event_types":{"default":"","description":"Comma-separated: EQ (earthquake), TC (tropical cyclone), FL (flood), VO (volcano), DR (drought), WF (wildfire).","type":"string"},"alert_levels":{"default":"","description":"Comma-separated: Green, Orange, Red.","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country name."},"news_timespan":{"default":"7d","description":"GDELT news lookback: 24h, 7d, 1m.","type":"string"},"max_events":{"default":25,"description":"Max disaster events.","type":"integer"},"max_articles":{"default":10,"description":"Max news articles.","type":"integer"},"min_magnitude":{"default":4.5,"description":"Minimum earthquake magnitude for USGS data.","type":"number"},"max_earthquakes":{"default":10,"description":"Max USGS earthquake results.","type":"integer"},"max_weather_alerts":{"default":10,"description":"Max NOAA weather alerts.","type":"integer"},"max_flood_warnings":{"default":10,"description":"Max NVE flood warnings (Norway).","type":"integer"},"max_smhi_warnings":{"default":10,"description":"Max SMHI weather warnings (Sweden).","type":"integer"},"max_dmi_warnings":{"default":10,"description":"Max DMI weather warnings (Denmark).","type":"integer"},"max_fmi_warnings":{"default":10,"description":"Max FMI weather warnings (Finland).","type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/crisis-intelligence/get_active_crises":{"post":{"tags":["Government"],"summary":"get_active_crises","description":"Get currently active disaster events worldwide from GDACS.\n\nReturns ongoing crises from the last 90 days. Defaults to Orange and Red\nalert levels — the most significant events requiring attention.\n\nEvent types:\n- EQ: Earthquake\n- TC: Tropical Cyclone\n- FL: Flood\n- VO: Volcano\n- DR: Drought\n- WF: Wildfire\n\nExamples:\n    get_active_crises()\n    get_active_crises(alert_levels=\"Red\")\n    get_active_crises(event_types=\"EQ,VO\", country=\"Japan\")","operationId":"crisis_intelligence_get_active_crises","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"event_types":{"default":"","description":"Comma-separated: EQ, TC, FL, VO, DR, WF. Empty = all types.","type":"string"},"alert_levels":{"default":"","description":"Comma-separated: Green, Orange, Red. Default: Orange,Red.","type":"string"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by country name."},"limit":{"default":50,"description":"Max events to return.","type":"integer"}},"type":"object"}}}}}},"/rest/crisis-intelligence/list_crisis_sources":{"post":{"tags":["Government"],"summary":"list_crisis_sources","description":"List all crisis intelligence data sources and their coverage.\n\nShows which disaster monitoring systems and news sources are queried\nduring crisis searches.\n\nExamples:\n    list_crisis_sources()","operationId":"crisis_intelligence_list_crisis_sources","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/crisis-intelligence/report_feedback":{"post":{"tags":["Government"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"crisis_intelligence_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Government","description":"Data sources: Government"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}