US severe weather (NWS, NHC, NWPS, FAA TFR)
Use this when you need current US severe-weather alerts, tropical storms, rivers in flood and FAA TFRs, reduced to state, region or zone (no coordinates or station IDs).
What it is
Mostly US: NWS Severe/Extreme alerts (zone text only), NHC active storms (name, classification, wind — no track), NOAA NWPS river gauges in flood (state + flood category, no gauge IDs) and FAA Temporary Flight Restrictions (state + kind). Not for navigation or flight planning.
Endpoints
- REST:
GET /v1/severe-weatheronhttps://api.cev-os.com - Legacy host (same service):
GET /v1/severe-weatheronhttps://cev-os.com - MCP tool:
get_severe_weatheronhttps://mcp.cev-os.com/mcp
Parameters
| Name | Type | Description | Constraints |
|---|---|---|---|
state | string | Two-letter USPS state filter (also matches NWS zone text). | example FL; pattern ^[A-Za-z]{2}$ |
Example request
No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).
curl -s "https://api.cev-os.com/v1/severe-weather?state=FL"
Example response
Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:
{
"count": 2,
"coverage": "Mostly US",
"alerts": [
{
"source": "nws",
"event": "Tornado Warning",
"zone": "Miami-Dade",
"state": "FL",
"severity": "Extreme",
"headline": "Tornado Warning for Miami-Dade"
},
{
"source": "nhc",
"name": "Pat",
"classification": "Hurricane",
"wind_kt": 90
}
]
}
Update frequency
TRIPWIRE: NWS 5 min, NHC 30 min, NWPS 60 min, FAA TFR 30 min; Data API caches 3 min.
- Public cache:
180seconds (Cache-Control: public, max-age=180).
Sources, license and usage
License status: cleared. NWS, NHC, NWPS and FAA TFR are US Government works. Not for navigation or flight planning.
| Source | License | commercialOk | Terms |
|---|---|---|---|
| NOAA / National Weather Service alerts | US Government work (public domain) | true | — |
| NOAA / National Hurricane Center | US Government work (public domain) | true | — |
| NOAA National Water Prediction Service | US Government work (public domain) | true | — |
| FAA Temporary Flight Restrictions | US Government work (public domain). Not for flight planning or navigation. | true | — |
Attribution (show this wherever you display the data):
- NOAA / National Weather Service (https://www.weather.gov/).
- NOAA / National Hurricane Center (https://www.nhc.noaa.gov/).
- NOAA National Water Prediction Service (https://water.noaa.gov/).
- FAA TFR list (https://tfr.faa.gov/). Not for navigation or flight planning.
Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).
Gaps
- Mostly CONUS / US waters. Reduced to state, zone or storm name; no coordinates or station IDs.
Disclaimer
Not an official warning. Not for navigation, life-safety or flight planning. Follow NWS, NHC and the FAA.
Related
- Data API hub (all products, limits, license notes)
- MCP Registry listing
com.cev-os/data - OpenAPI 3.1
- Machine product list:
/v1/products
Reference data, not investment advice.