Log inSubmit server
Nws Weather MCP Server logo

Nws Weather MCP Server

US forecasts, alerts, observations, station history, and NWS forecaster products through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Nws Weather MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "nws-weather-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/nws-weather-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

nws-weather-mcp-server connects MCP clients to the US National Weather Service API for forecasts, alerts, observations, station history, and forecaster discussions. It accepts coordinates, station IDs, alert filters, and forecast-zone or office identifiers, then returns structured weather data through ten tools. Use it for US and territory weather workflows that need current conditions, alert monitoring, or forecast context without an API key. The server supports STDIO and Streamable HTTP, including a hosted endpoint.

Use cases

  • Retrieve a seven-day forecast for a US coordinate
  • Monitor active weather alerts by state, point, zone, or marine area
  • Check current conditions and recent readings from nearby NWS stations
  • Review a Weather Forecast Office discussion alongside forecast data
  • Find valid NWS alert event types for filtered searches

Key features

  • National Weather Service forecasts for coordinates
  • Active alert search and alert-count reporting
  • Current observations and approximately seven days of station history
  • Nearby station discovery with distance and bearing
  • Weather Forecast Office narrative products
  • STDIO and Streamable HTTP transports

Tools10

What Nws Weather MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~246 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/8 checks healthy over the last 53d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @cyanheads/nws-weather-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads2.1kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Tools exposed10Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Nws Weather MCP Server works

What nws-weather-mcp-server does

nws-weather-mcp-server exposes National Weather Service data to MCP-compatible AI clients. Its coverage includes the 50 states and US territories, with support for land forecasts, active alerts, current station observations, recent observation history, forecast zones, and narrative products from Weather Forecast Offices.

Forecast requests can return named 12-hour periods for roughly seven days or hourly periods. Alert tools support national, state or territory, marine, point, area, zone, event, severity, urgency, certainty, and status-oriented queries. Observation tools can resolve the nearest station from coordinates or work directly with a station ID.

The server also provides two MCP resources: a static NWS alert-type list at nws://alert-types and a weather guide at skill://nws-weather-guide/SKILL.md for combining forecasts, alerts, station trends, and forecaster discussions.

How it works

Coordinate-based forecast requests resolve the appropriate NWS grid internally. Observation lookups resolve a nearby station unless a station ID is supplied. Station discovery returns nearby stations ordered by distance and includes identifiers that can be passed to observation tools.

Alert searches can be paged with cursors. Cursors retain the relevant query mode and filters, allowing an agent to continue a result walk without rebuilding the request. Forecast paging similarly preserves hourly mode. Observation history is returned newest first and can be constrained by an ISO 8601 time window.

The server returns NWS-derived details such as forecast update times, alert references and issuing offices, dual-unit measurements, precipitation intervals, and staleness notices. Large forecaster products are represented by a section outline rather than being placed entirely inline.

Setup and configuration

No National Weather Service API key is required. The package can be launched through npx using:

Terminal
npx -y @cyanheads/nws-weather-mcp-server

It supports STDIO for local MCP client configurations and Streamable HTTP for network access. A public hosted endpoint is available at https://nws.caseyjhand.com/mcp. Claude Desktop, Cursor, and VS Code have installation links associated with the project. Docker packaging is also available.

Tools and capabilities

  • nws_get_forecast returns seven-day or hourly forecasts, with optional precipitation, snowfall, and ice-accumulation amounts.
  • nws_search_alerts filters active or other alert statuses by geography and alert attributes.
  • nws_get_alert retrieves current or superseded messages by alert identifier.
  • nws_get_alert_counts reports national, state or territory, and marine alert counts.
  • nws_get_observations returns current conditions from coordinates or a station ID.
  • nws_get_observation_history pages through approximately seven days of station reports.
  • nws_find_stations locates nearby stations and returns distance, bearing, and station identifiers.
  • nws_list_alert_types lists valid NWS event names for constructing filters.
  • nws_get_office_discussion retrieves the latest AFD, HWO, ZFP, SPS, or FWF product from an NWS office.
  • nws_get_zone_forecast returns text forecast periods for an NWS forecast zone.

Limitations and notes

Coverage and behavior follow the National Weather Service API. Marine coordinates are unsupported by the grid forecast tool, and some land points may not have an NWS forecast grid. NWS retains observation history and alert messages for about seven days. Current observations can be older than two hours and may contain unavailable measurements.

Alert-count totals include every message status, including Test and Exercise, while alert search defaults to Actual. Area counts can overlap because one alert may apply to multiple zones. Forecast and alert result limits are capped, and a cursor is required to retrieve additional pages.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Nws Weather MCP Server

nws-weather-mcp-server is an MCP server that connects AI clients to the US National Weather Service API. Its main tools retrieve seven-day or hourly forecasts, search and fetch alerts, count active alerts, read current and historical station observations, find stations, list alert types, and retrieve office discussions and zone forecasts.

Install it with `npx -y @cyanheads/nws-weather-mcp-server`. The package supports STDIO and Streamable HTTP, and the project also provides installation links for Claude Desktop, Cursor, and VS Code.

No, nws-weather-mcp-server does not require a National Weather Service API key. You can run the package locally over STDIO or connect to the hosted Streamable HTTP endpoint at `https://nws.caseyjhand.com/mcp`.

Yes, it retrieves recent observations for an NWS station, newest first, with paging through approximately the seven days retained by the National Weather Service. Use `nws_find_stations` to locate a station and `nws_get_observation_history` to query its records.

It can query marine alerts and marine alert counts, but coordinate-based grid forecasts do not support marine coordinates. The forecast tool reports an unsupported-marine error when used with those coordinates.

Related MCP servers

All in Environment & Nature All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNws Weather MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/nws-weather-mcp-server?style=directory)](https://allmcps.com/mcp/nws-weather-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/nws-weather-mcp-server"><img src="https://allmcps.com/api/badge/nws-weather-mcp-server?style=directory" alt="Nws Weather MCP Server on AllMCPs" /></a>