{"openapi":"3.0.3","info":{"title":"Gnist Context — NOAA Weather Alerts","description":"Active U.S. weather alerts — watches, warnings, and advisories by area.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/noaa-alerts/`\n- **Toolkit page:** `/toolkits/noaa-alerts`\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/noaa-alerts/get_active_alerts":{"post":{"tags":["Environment"],"summary":"get_active_alerts","description":"Get all currently active NOAA weather alerts and warnings across the US.\n\nReturns real-time National Weather Service alerts including severe weather\nwarnings, watches, advisories, and statements. Data covers all US states,\nterritories, and marine zones.\n\nArgs:\n    state: Two-letter US state/territory code to filter by (e.g. \"CA\", \"TX\", \"PR\").\n    severity: Filter by severity level — \"Extreme\", \"Severe\", \"Moderate\", \"Minor\".\n    event: Filter by event type (e.g. \"Tornado Warning\", \"Winter Storm Watch\").\n    urgency: Filter by urgency — \"Immediate\", \"Expected\", \"Future\", \"Past\".\n    certainty: Filter by certainty — \"Observed\", \"Likely\", \"Possible\", \"Unlikely\".\n    limit: Maximum results to return (1-500, default 50).\n\nReturns:\n    Dict with 'count' and 'results' list of active alerts. Each alert includes\n    event type, severity, headline, description, affected areas, and timing.","operationId":"noaa_alerts_get_active_alerts","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":{"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state/territory code to filter by (e.g. \"CA\", \"TX\", \"PR\")."},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by severity level — \"Extreme\", \"Severe\", \"Moderate\", \"Minor\"."},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by event type (e.g. \"Tornado Warning\", \"Winter Storm Watch\")."},"urgency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by urgency — \"Immediate\", \"Expected\", \"Future\", \"Past\"."},"certainty":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by certainty — \"Observed\", \"Likely\", \"Possible\", \"Unlikely\"."},"limit":{"default":50,"description":"Maximum results to return (1-500, default 50).","type":"integer"}},"type":"object"}}}}}},"/rest/noaa-alerts/get_alerts_for_point":{"post":{"tags":["Environment"],"summary":"get_alerts_for_point","description":"Get active weather alerts for a specific geographic point in the US.\n\nReturns all current NWS alerts that cover the given latitude/longitude,\nuseful for location-specific weather safety checks.\n\nArgs:\n    latitude: Latitude of the point (-90 to 90).\n    longitude: Longitude of the point (-180 to 180).\n    limit: Maximum results to return (1-100, default 20).\n\nReturns:\n    Dict with 'count' and 'results' list of alerts affecting the given point.","operationId":"noaa_alerts_get_alerts_for_point","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":{"latitude":{"description":"Latitude of the point (-90 to 90).","type":"number"},"longitude":{"description":"Longitude of the point (-180 to 180).","type":"number"},"limit":{"default":20,"description":"Maximum results to return (1-100, default 20).","type":"integer"}},"required":["latitude","longitude"],"type":"object"}}}}}},"/rest/noaa-alerts/get_alert":{"post":{"tags":["Environment"],"summary":"get_alert","description":"Get detailed information about a specific weather alert by its NWS alert ID.\n\nArgs:\n    alert_id: The NWS alert identifier (e.g. \"urn:oid:2.49.0.1.840.0.abc123\").\n\nReturns:\n    Dict with full alert details including headline, description, safety\n    instructions, severity, affected areas, and timing. Returns an error\n    if the alert is not found.","operationId":"noaa_alerts_get_alert","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":{"alert_id":{"description":"The NWS alert identifier (e.g. \"urn:oid:2.49.0.1.840.0.abc123\").","type":"string"}},"required":["alert_id"],"type":"object"}}}}}},"/rest/noaa-alerts/report_feedback":{"post":{"tags":["Environment"],"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":"noaa_alerts_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":"Environment","description":"Data sources: Environment"}],"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."}}}}