Nws MCP Server

Real-time US weather data via National Weather Service API. Forecasts, alerts, and observations.

Remote serverstreamable-http

What is the Nws MCP Server?

Real-time US weather data via National Weather Service API. Forecasts, alerts, and observations.

What it actually does

  • 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

Configuration

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
nws_get_forecast7-day or hourly forecast for coordinates. Resolves NWS grid internally.
nws_search_alertsActive weather alerts filtered by area, point, zone, event, severity, urgency, certainty, and status.
nws_get_observationsCurrent conditions by coordinates (nearest station) or station ID.
nws_find_stationsNearby observation stations sorted by distance with bearing.
nws_list_alert_typesAll valid alert event type names for filter discovery.
nws_get_office_discussionLatest narrative product (AFD, HWO, ZFP, SPS) from a Weather Forecast Office.
nws_get_zone_forecastText forecast periods for a public NWS forecast zone.

How to install the Nws MCP Server

{
  "mcpServers": {
    "nws-weather-mcp-server": {
      "type": "streamable-http",
      "url": "https://nws.caseyjhand.com/mcp"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MCP_TRANSPORT_TYPEConfiguration value read at startup.Optional
MCP_LOG_LEVELConfiguration value read at startup.Optional
MCP_HTTP_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • “Use Nws to nws get forecast.”
  • “Use Nws to nws search alerts.”
  • “Use Nws to nws get observations.”

Frequently asked questions

Real-time US weather data via National Weather Service API. Forecasts, alerts, and observations. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.