Tools (4)

get_active_alerts
get_alerts_for_point
get_alert
report_feedback

get_active_alerts

Get all currently active NOAA weather alerts and warnings across the US.

Returns real-time National Weather Service alerts including severe weather
warnings, watches, advisories, and statements. Data covers all US states,
territories, and marine zones.

Args:
state: Two-letter US state/territory code to filter by (e.g. "CA", "TX", "PR").
severity: Filter by severity level — "Extreme", "Severe", "Moderate", "Minor".
event: Filter by event type (e.g. "Tornado Warning", "Winter Storm Watch").
urgency: Filter by urgency — "Immediate", "Expected", "Future", "Past".
certainty: Filter by certainty — "Observed", "Likely", "Possible", "Unlikely".
limit: Maximum results to return (1-500, default 50).

Returns:
Dict with 'count' and 'results' list of active alerts. Each alert includes
event type, severity, headline, description, affected areas, and timing.

Parameter	Type	Required	Description
`state`	`any`	optional	Two-letter US state/territory code to filter by (e.g. "CA", "TX", "PR").
`severity`	`any`	optional	Filter by severity level — "Extreme", "Severe", "Moderate", "Minor".
`event`	`any`	optional	Filter by event type (e.g. "Tornado Warning", "Winter Storm Watch").
`urgency`	`any`	optional	Filter by urgency — "Immediate", "Expected", "Future", "Past".
`certainty`	`any`	optional	Filter by certainty — "Observed", "Likely", "Possible", "Unlikely".
`limit`	`integer`	optional	Maximum results to return (1-500, default 50). (default: 50)

Request Body

{
  "query": "example"
}

get_alerts_for_point

Get active weather alerts for a specific geographic point in the US.

Returns all current NWS alerts that cover the given latitude/longitude,
useful for location-specific weather safety checks.

Args:
latitude: Latitude of the point (-90 to 90).
longitude: Longitude of the point (-180 to 180).
limit: Maximum results to return (1-100, default 20).

Returns:
Dict with 'count' and 'results' list of alerts affecting the given point.

Parameter	Type	Required	Description
`latitude`	`number`	required	Latitude of the point (-90 to 90).
`longitude`	`number`	required	Longitude of the point (-180 to 180).
`limit`	`integer`	optional	Maximum results to return (1-100, default 20). (default: 20)

Request Body

{
  "latitude": 1.0,
  "longitude": 1.0
}

get_alert

Get detailed information about a specific weather alert by its NWS alert ID.

Args:
alert_id: The NWS alert identifier (e.g. "urn:oid:2.49.0.1.840.0.abc123").

Returns:
Dict with full alert details including headline, description, safety
instructions, severity, affected areas, and timing. Returns an error
if the alert is not found.

Parameter	Type	Required	Description
`alert_id`	`string`	required	The NWS alert identifier (e.g. "urn:oid:2.49.0.1.840.0.abc123").

Request Body

{
  "alert_id": "example"
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/noaa-alerts/get_alerts_for_point" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"latitude": 1.0, "longitude": 1.0}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/noaa-alerts/get_alerts_for_point",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "latitude": 1.0,
  "longitude": 1.0
},
)
print(resp.json())