nws-weather-mcp-server

---

Tools

Five tools for real-time US weather data:

Tool	Description
nws_get_forecast	7-day or hourly forecast for coordinates. Resolves NWS grid internally.
nws_search_alerts	Active weather alerts filtered by area, point, zone, event, severity, urgency, certainty, and status.
nws_get_observations	Current conditions by coordinates (nearest station) or station ID.
nws_find_stations	Nearby observation stations sorted by distance with bearing.
nws_list_alert_types	All valid alert event type names for filter discovery.

nws_get_forecast

Get the weather forecast for a US location.

• Default returns named 12-hour periods (14 total, ~7 days)
• Hourly mode returns up to 156 one-hour periods with dewpoint and humidity
• Coordinates resolve to NWS grid internally via /points endpoint
• Formatted timestamps use the resolved local time zone
• Returns forecast zone and county zone codes for chaining into nws_search_alerts

---

nws_search_alerts

Search active weather alerts with flexible filtering.

• Filter by area (state/territory/marine codes), point (lat,lon), zone, event type, severity, urgency, certainty, or status
• area, point, and zone are mutually exclusive; specify at most one location filter
• National search when no filters provided
• Blank optional location filters are ignored so form-based clients can submit empty fields safely
• Event matching is case-insensitive and partial, so "tornado" matches both watches and warnings
• status defaults to live Actual alerts, but can be set to Exercise, System, Test, or Draft
• Results capped at 25 with truncation notice and guidance to narrow filters
• Validates area codes and point format before API call

---

nws_get_observations

Current measured conditions from a weather station.

• Look up by coordinates (finds nearest station) or station ID directly
• Blank or whitespace-only station_id values are ignored so clients can fall back to coordinates cleanly
• Coordinate lookups choose the nearest station from the candidates returned by NWS
• Dual-unit display: F/C, mph/km/h, inHg/hPa, mi/km
• Observation timestamps use the station's local time zone when available
• Warns when most measurements are unavailable from a station

---

nws_find_stations

Discover nearby observation stations.

• Sorted by haversine distance from query point
• Returns distance (km) and compass bearing
• Includes zone codes, elevation, time zone
• Useful for finding station IDs for nws_get_observations

---

nws_list_alert_types