> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Weather

**Authentication:** No authentication required (public API).

## Sample use cases

* What's the weather in San Francisco tomorrow?
* Pull the 7-day forecast for New York and Tokyo and compare temperatures.
* Find days in the next 14 with rain forecast for the Seattle office.

## Available Tools

#### list\_active\_alerts

List active weather alerts with optional filters for area, zone, event type, severity, urgency, and certainty. Use cursor from page\_info for next page.

#### get\_alert

Get a specific weather alert by its ID. Returns full alert details including description and instructions.

#### list\_alert\_types

List all possible weather alert event types (e.g., 'Winter Storm Warning', 'Tornado Watch'). Useful for filtering alerts.

#### get\_point\_info

Get metadata for a geographic point including grid office, forecast URLs, and nearby city. Use this first to discover grid coordinates for other tools.

#### get\_forecast

Get the daily forecast for a location (up to 7 days). Returns named periods like 'Tonight', 'Tuesday'. Requires latitude and longitude.

#### get\_hourly\_forecast

Get hourly forecast for a location (up to 156 hours). Returns temperature, wind, and conditions for each hour. Requires latitude and longitude.

#### get\_gridpoint\_data

Get raw gridpoint data including temperature, dewpoint, humidity, wind, and precipitation arrays. Use get\_point\_info first to find office/grid coordinates.

#### get\_office

Get details for a Weather Forecast Office by ID (e.g., 'BOU' for Boulder, CO). Returns address, phone, email, and responsible zones.

#### list\_office\_headlines

List headlines for a Weather Forecast Office. Headlines are short announcements about significant weather events.

#### list\_products

List NWS text products (forecasts, discussions, warnings). Filter by office (e.g., 'BOU' or 'KBOU') or type. Use cursor from page\_info for next page.

#### get\_product

Get a specific NWS text product by ID. Returns the full product text content.

#### list\_product\_types

List all available NWS product type codes (e.g., 'AFD' for Area Forecast Discussion). Useful for filtering with list\_products.

#### list\_stations

List weather observation stations. Filter by state. Use cursor from page\_info for next page. Use get\_station for details on a specific station.

#### get\_station

Get details for a specific observation station by its ID (e.g., 'KDEN'). Returns location, timezone, and elevation.

#### get\_latest\_observation

Get the most recent weather observation from a station. Returns temperature, wind, humidity, pressure, and conditions. Use list\_stations to find station IDs.

#### list\_observations

List recent observations from a station with optional time range filter. Use list\_stations to find station IDs.

#### list\_zones

List weather zones by type (forecast, fire, county, coastal, offshore). Filter by state or region. Returns zone IDs for use with get\_zone\_forecast.

#### get\_zone

Get details for a specific zone by type and ID (e.g., type='forecast', id='COZ040'). Returns zone name, state, and associated offices.

#### get\_zone\_forecast

Get the text forecast for a zone. Use list\_zones to find zone IDs. Returns named periods with detailed forecast text.