NWS (US National Weather Service)

live WeatherGovernment

Authoritative US weather: 7-day + hourly forecasts, severe-weather alerts, station observations. No auth (UA-tagged). US locations only.

4 tools
0ms auth
free tier 50 calls/day

Tools

get_forecast required: latitude, longitude

7-day text forecast for a US lat/lon.

Parameters
Name Type Description
latitude req number US latitude
longitude req number US longitude
Try it
get_hourly_forecast required: latitude, longitude

Hourly forecast for a US lat/lon.

Parameters
Name Type Description
latitude req number US latitude
longitude req number US longitude
max_hours opt number Cap hours (default 24)
Try it
get_alerts

Active watches/warnings/advisories. Filter by state, point, severity, urgency, or event.

Parameters
Name Type Description
area opt string 2-letter state code
latitude opt number Point latitude
longitude opt number Point longitude
severity opt string Extreme | Severe | Moderate | Minor | Unknown
urgency opt string Immediate | Expected | Future | Past | Unknown
event opt string Event type filter
limit opt number Cap (default 50, max 500)
Try it
get_observation required: station_id

Latest observation from an ICAO station.

Parameters
Name Type Description
station_id req string 4-char ICAO station (e.g., KSFO)
Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/nws/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/nws/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_forecast","arguments":{"latitude": 37.7749, "longitude": -122.4194}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_forecast", {"latitude":"example","longitude":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("authoritative us weather: 7-day + hourly forecasts, severe-weather alerts, station observations");