# `nws__nws_get_zone_forecast` **Nws Get Zone Forecast** Get the text forecast for a public NWS forecast zone. Returns named forecast periods (e.g., "Today", "Tonight", "Monday") with detailed narrative text — the human-readable, zone-level forecast written by local forecasters. Completes the alert-to-forecast chain: nws_search_alerts returns each affected zone in "affectedZones" as a code plus a type, and nws_find_stations returns codes in the "forecastZone" column. Only affectedZones entries with type "forecast" work here; entries typed "county" or "fire" have no text forecast upstream and will not resolve. Zone codes follow the pattern XXZ### (e.g., "WAZ315" for Western Washington lowlands). - Server: [US National Weather Service](https://gateway.mcpharbor.dev/docs/servers/nws) (`dev.mcpharbor.gateway/nws`) - Price per call: $0.0001 (100 micro-USD); only tools/call is charged - Endpoint: `https://gateway.mcpharbor.dev/mcp` or `https://gateway.mcpharbor.dev/mcp/nws` - Upstream tool: exposed by the provider; called through this gateway as `nws__nws_get_zone_forecast` - Provider terms: (verified 2026-09-19) - Upstream API documentation: - Rate limit: 300 requests per minute - Attribution required: No attribution required. Must not claim the content as your own, imply NOAA/NWS endorsement, or modify content and present it as official government material. Third parties producing copyrighted works predominantly of NWS material must add a notice identifying the NWS material as not subject to copyright. A User-Agent identifying the app (ideally with contact info) is required on every request. ## Parameters - `zone_id` (string, required): NWS public forecast zone code (e.g., "WAZ315" for the Western Washington lowlands including Seattle). Returned as "forecastZone" by nws_get_forecast and nws_find_stations, or as the "code" of an "a... ## Example call Request headers and body: ```http POST /mcp HTTP/1.1 Host: gateway.mcpharbor.dev Authorization: Bearer Content-Type: application/json Accept: application/json, text/event-stream MCP-Protocol-Version: 2026-07-28 Mcp-Method: tools/call Mcp-Name: nws__nws_get_zone_forecast ``` ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "_meta": { "io.modelcontextprotocol/clientCapabilities": {}, "io.modelcontextprotocol/clientInfo": { "name": "example-agent", "version": "1.0.0" }, "io.modelcontextprotocol/protocolVersion": "2026-07-28" }, "arguments": { "zone_id": "example" }, "name": "nws__nws_get_zone_forecast" } } ``` A successful response: ```json { "id": 1, "jsonrpc": "2.0", "result": { "_meta": { "dev.mcpharbor.gateway/call": { "chargedMicroUsd": 100, "id": "" } }, "content": [ { "text": "", "type": "text" } ], "resultType": "complete" } } ``` This call costs $0.0001 (100 micro-USD). Reading this page and listing the tool cost nothing. The `dev.mcpharbor.gateway/call` record in the result is the receipt for that charge. Each POST is metered separately, so sending the same call again buys another one: see [agent.txt](https://gateway.mcpharbor.dev/agent.txt), section 7, before retrying. ## Attribution This provider requires the attribution below wherever you use results from its tools. Reproduce it verbatim: > No attribution required. Must not claim the content as your own, imply NOAA/NWS endorsement, or modify content and present it as official government material. Third parties producing copyrighted wo... ## Tool definition Exactly as `tools/list` returns it (free): ```json { "_meta": { "dev.mcpharbor.gateway/pricing": { "currency": "USD", "pricePerCallMicroUsd": 100 } }, "annotations": { "readOnlyHint": true }, "description": "Get the text forecast for a public NWS forecast zone. Returns named forecast periods (e.g., \"Today\", \"Tonight\", \"Monday\") with detailed narrative text — the human-readable, zone-level forecast written by local forecasters. Completes the alert-to-forecast chain: nws_search_alerts returns each affected zone in \"affectedZones\" as a code plus a type, and nws_find_stations returns codes in the \"forecastZone\" column. Only affectedZones entries with type \"forecast\" work here; entries typed \"county\" or \"fire\" have no text forecast upstream and will not resolve. Zone codes follow the pattern XXZ### (e.g., \"WAZ315\" for Western Washington lowlands).", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "zone_id": { "description": "NWS public forecast zone code (e.g., \"WAZ315\" for the Western Washington lowlands including Seattle). Returned as \"forecastZone\" by nws_get_forecast and nws_find_stations, or as the \"code\" of an \"affectedZones\" entry with type \"forecast\" in nws_search_alerts. Format: two-letter state + \"Z\" + three-digit number.", "minLength": 1, "type": "string" } }, "required": [ "zone_id" ], "type": "object" }, "name": "nws__nws_get_zone_forecast", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "not": { "required": [ "error" ] }, "required": [ "zoneId", "updated", "periods", "periodCount" ] }, { "required": [ "error" ] } ], "properties": { "error": { "additionalProperties": {}, "description": "Present when the call failed. Absent on success.", "properties": { "code": { "description": "JSON-RPC error code for this failure.", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "data": { "additionalProperties": {}, "properties": { "reason": { "description": "Machine-readable failure mode. Declared by this tool: `zone_not_found`: Zone code is not a valid public forecast zone or has no forecast available. Other values are possible when a failure originates below the handler.", "examples": [ "zone_not_found" ], "type": "string" }, "recovery": { "additionalProperties": {}, "description": "Actionable next step for the caller.", "properties": { "hint": { "type": "string" } }, "required": [ "hint" ], "type": "object" }, "retryable": { "description": "Whether retrying may succeed.", "type": "boolean" } }, "type": "object" }, "message": { "description": "Human-readable description of what went wrong.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "periodCount": { "description": "Number of forecast periods returned.", "type": "number" }, "periods": { "description": "Forecast periods in chronological order, typically covering 7 days.", "items": { "additionalProperties": false, "description": "Single forecast period with name and narrative", "properties": { "detailedForecast": { "description": "Full narrative forecast for this period, written by local forecasters (e.g., \"Partly cloudy. Highs in the upper 60s. Southwest winds 10 to 15 mph.\").", "type": "string" }, "name": { "description": "Period name (e.g., \"Today\", \"Tonight\", \"Monday\").", "type": "string" }, "number": { "description": "Period sequence number, starting at 1.", "type": "number" } }, "required": [ "number", "name", "detailedForecast" ], "type": "object" }, "type": "array" }, "updated": { "description": "When the zone forecast was last updated (ISO 8601 with timezone offset).", "type": "string" }, "zoneId": { "description": "Zone ID as provided (e.g., \"WAZ315\").", "type": "string" } }, "type": "object" }, "title": "Nws Get Zone Forecast" } ```