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. | | 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

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
• National search when no filters provided
• 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
• Dual-unit display: F/C, mph/km/h, inHg/hPa, mi/km
• 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

List all valid NWS alert event type names.

• Returns the full set of event types the NWS API recognizes (e.g., "Tornado Warning", "Heat Advisory")
• Use to discover valid values for the event filter in nws_search_alerts

Resources

| URI Pattern | Description | |:------------|:------------| | nws://alert-types | Static list of all valid NWS alert event type names. |

Features

Built on @cyanheads/mcp-ts-core:

• Declarative tool definitions — single file per tool, framework handles registration and validation
• Unified error handling across all tools
• Pluggable auth (none, jwt, oauth)
• Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
• Structured logging with optional OpenTelemetry tracing
• Runs locally (stdio/HTTP) or on Cloudflare Workers from the same codebase

NWS-specific:

• Zero-auth access to t

... View full README on GitHub