Skip to content
ToolCargo

NWS Weather Planning

Live

Resolve a US forecast grid. Read the forecast with its source times.

Look up an explicit US location’s NWS office and grid, then inspect period or hourly forecasts in US or SI units. Preserve source timestamps, uncertainty and missing values for practical planning research.

Connect / 3 tools

Server URL

streamable http
https://toolcargo.com/mcp/nws-weather

Claude Code

terminal
claude mcp add --transport http --scope user toolcargo-nws-weather https://toolcargo.com/mcp/nws-weather \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

  • Exact US forecast grid mapping
  • Period and hourly forecast research
  • Source units and update times

Built for: Agents researching US outdoor schedules and travel conditions.

Example requests

Compare forecast windows for an outdoor plan

“Look up latitude 38.8977 and longitude -77.0365 with NWS. Use the returned office and grid to inspect period and hourly forecasts in SI units. Cite source update times, preserve missing probabilities and explain that these are grid forecasts rather than observations.”

Source-linked forecast windows with exact periods, units and freshness context.

Explore useful agent workflows ↗

Tools

ToolWhat it doesAccess
nws_point
Resolve a US forecast grid
Look up explicit coordinates rounded to four decimals in the public NWS API. Return exact office/grid mapping, timezone and validated forecast pointers. US/NWS coverage only; nearby city is context, not point conditions. One shared-plan call.Read-only
nws_grid_forecast
Read a period grid forecast
Read one exact NWS office/grid forecast, US or SI units. Preserve source time ranges, temperature units, probabilities, wind text and narrative. At most 10 periods per explicit local page, offset 0–200; forecast can change between calls. Not observations or alerts. One shared-plan call.Read-only
nws_hourly_forecast
Read an hourly grid forecast
Read a bounded explicit page of hourly NWS grid forecasts with source timestamps, units, dewpoint, humidity and null values. At most 10 periods, offset 0–200. Grid predictions are not measured point conditions or emergency monitoring. One shared-plan call.Read-only

Requirements

  • • Activate Site Audit free and use ToolCargo OAuth or a scoped API key. No NWS account, API key or paid provider.

Limitations

  • • NWS coverage is US locations and supported territories; not a global weather service. Some marine or uncovered locations lack text forecasts. Recheck point mappings periodically because offices/grid cells can change.
  • • Coordinates are rounded to four decimals before reaching NWS. Grid forecasts represent approximately 2.5 km cells, not measured weather at the supplied point.
  • • At most ten periods per explicit local page, offset 0–200. Each page refetches the full bounded forecast; source order and values can change between calls. No pinned snapshot or automatic paging.
  • • Source units, timestamps and missing values are preserved. Freshness age is derived from updateTime with no guaranteed threshold; numeric probabilities and rounded narrative percentages may differ.
  • • Fixed public JSON requests with identifying application contact, shared provider pacing, 15-second timeout and 2 MB response cap. No retries, redirected/followed URLs, geocoding, observations, alerts, emergency monitoring or weather guarantees.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. Recorded client-specific tests currently cover Site Audit. Other connectors use the documented setup until tested in that client.

Claude CodeAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
Claude (claude.ai)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
CursorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
VS Code (Copilot agent mode)API key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
ChatGPT (developer mode)OAuth sign-inDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.
MCP InspectorAPI key headerDocumented, not yet testedThis endpoint has not yet been tested in this client. See the setup guide.

Practical workflows

Pricing

Included with Site Audit. Each successful point lookup or forecast page uses one shared-plan call.

Free

$0

Try hosted tools with a shared monthly allowance.

50 shared calls/month

Pro

$12/mo

Proposed larger shared allowance; see checkout status on the pricing page.

2,000 shared calls/month

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details