nws-weather-mcp-server
Server Details
Get US weather forecasts, active alerts, and current observations.
- Status
- Healthy
- Uptime
- 99.9% over 79 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/nws-weather-mcp-server
- GitHub Stars
- 1
- Server Listing
- @cyanheads/nws-weather-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 10 tools
Most tools target clearly distinct resources, and the descriptions explicitly separate current observations from observation history, alert search from alert lookup, and station discovery from point/zone forecasts. The main residual overlap is among the forecast-oriented tools (nws_get_forecast, nws_get_zone_forecast, and nws_get_office_discussion), which can all plausibly answer a general forecast request for the same place.
Every tool follows the same nws_verb_noun convention with predictable verbs (get, find, list, search). The resource names are descriptive and consistently snake_case throughout.
Ten tools is a well-scoped set for an NWS weather server, covering alerts, forecasts, observations, stations, and office discussions without obvious filler. Each tool appears to earn its place.
The read-only weather surface is strong: alert search/get/counts/types, point and zone forecasts, office discussions, station discovery, current observations, and observation history. Minor gaps remain, such as no explicit zone/office lookup tool or station metadata endpoint, but agents can generally work around them through existing forecast and station outputs.
Available Tools
10 toolsnws_find_stationsNws Find StationsARead-onlyInspect
Find weather observation stations near a location. Returns stations sorted by proximity with distance and bearing. Use to discover station IDs for nws_get_observations.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max stations per page. A page holds at most 50; a larger limit (up to 10000) is served as 50 and reported through requestedLimit and effectiveLimit. totalCount still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest. | |
| cursor | No | Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches the station list, so pages are contiguous within one response; the registry changes rarely, but a later call can window an updated list. | |
| latitude | Yes | Center latitude for proximity search. | |
| longitude | Yes | Center longitude for proximity search. |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| shown | No | Number of stations returned in this page |
| notice | No | Guidance when the requested limit exceeded the page cap, when no stations were found near the requested coordinates, when stations remain beyond this page, or when the supplied cursor points past the end of the list. |
| stations | No | Nearby stations sorted by distance |
| nextCursor | No | Opaque token for the next page of stations — pass it back as `cursor`. Omitted when this is the last page. |
| totalCount | No | Total observation stations available near this location before the page limit was applied — NOT the number returned in this page, which is shown. Same value on every page of one query; compare it against shown to tell whether stations were withheld. |
| effectiveLimit | No | The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap. |
| requestedLimit | No | The limit asked for, when it exceeded the 50-station page cap; absent otherwise. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
readOnlyHint=true already tells the agent this is a safe read, so the burden is lower. The description contributes the ordering guarantee and the downstream purpose, and the schema carries the detailed pagination/stability disclosure. Nothing extra is added about rate limits or data freshness beyond what's in the schema, so a solid-but-not-rich 3.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded with what it does, then the return shape, then the downstream use. There is no filler and no repetition of schema content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description needn't explain return fields, and it still names the proximity ordering and the follow-up tool. It is close to complete for a discovery tool; only the pagination caveat lives solely in the schema, which is acceptable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the schema already explains limit, cursor windowing, requestedLimit/effectiveLimit, and coordinate bounds in more depth than the description does. The description only echoes the output-side effect of proximity sorting, not any parameter syntax. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ("Find weather observation stations near a location") and adds the result shape (sorted by proximity with distance and bearing). It explicitly ties itself to a sibling, nws_get_observations, so an agent can place it in the workflow without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives clear positive usage context: "Use to discover station IDs for nws_get_observations." That prerequisite relationship is genuinely helpful routing. It stops short of the top mark because no when-not condition or alternative discovery tool is named.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_alertNws Get AlertARead-onlyInspect
Fetch one NWS alert message by ID — a current alert, or an earlier message that an update or cancellation has since superseded and that an active-alert search no longer returns. Takes an id from nws_search_alerts or a references[].identifier from any alert, and returns the same alert fields nws_search_alerts does. The message carries its own references, newest first, so a revision chain is walked one call per message. Every reference sharing the newest sent time is an immediate predecessor (an update can merge several earlier segments), so references[0] is one of them, not always the only one. NWS serves messages for about 7 days after they are sent.
| Name | Required | Description | Default |
|---|---|---|---|
| alert_id | Yes | NWS alert message ID, e.g. "urn:oid:2.49.0.1.840.0.654087301e4bfcbe71d24494c26a965e54d3a1ad.001.1": the id of an alert from nws_search_alerts, or the identifier of one of its references. Pass it exactly as returned; IDs are case-sensitive. |
Output Schema
| Name | Required | Description |
|---|---|---|
| alert | No | Single alert message with event, severity, area, and timing |
| error | No | Present when the call failed. Absent on success. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With readOnlyHint=true already supplied by annotations, the description adds substantial behavioral context: NWS retains messages for about 7 days, references are newest first, and an update may merge several earlier segments so references[0] is not necessarily the only immediate predecessor. This goes well beyond the safety annotation and helps the agent interpret retrieval and revision behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the core action and then adds useful operational context. It is dense but most sentences earn their place; the detailed references[0] explanation is somewhat heavy, but it directly supports correct revision-chain traversal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return fields need not be fully described, and the description explicitly says the response matches nws_search_alerts. It covers ID provenance, retention duration, revision-chain semantics, and the distinction from active-alert search, leaving no important gap for invoking the tool correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, and the schema already documents the alert_id format, pattern, case sensitivity, and example. The description adds provenance for the ID and notes that it returns the same fields as nws_search_alerts, but does not add format or syntax details beyond the schema. The baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: fetch one NWS alert message by ID. It immediately distinguishes this from nws_search_alerts by explaining that it can retrieve current alerts as well as superseded messages that active-alert searches no longer return.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly identifies valid ID sources, nws_search_alerts results or references[].identifier from any alert, and explains when to use this tool instead of an active-alert search. The revision-chain guidance tells the agent how to walk superseded messages one call per message.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_alert_countsNws Get Alert CountsARead-onlyInspect
Count active weather alerts nationwide, per state/territory or marine area, and per marine region, in one small response — the answer to "how many alerts are active, and where" without fetching the alerts themselves. Counts cover every message status, Test and Exercise included, so totalAlerts can run above the totalCount a national nws_search_alerts search reports under its default status of Actual. An alert counts once in each area its zones fall in, so the area counts can sum past totalAlerts; landAlerts plus marineAlerts equals totalAlerts. Takes no filters. For counts per zone or under a filter, call nws_search_alerts with that zone or filter and read its totalCount.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| areas | No | Active alert counts keyed by state/territory code (e.g., "WA", "PR") or marine area code (e.g., "PZ", "GM"). Only areas with an active alert appear. An alert counts once in each area its zones fall in, so these can sum past totalAlerts. Area "AL" is Alabama; Alaska waters are region "AL" in regions. |
| error | No | Present when the call failed. Absent on success. |
| regions | No | Active marine alert counts keyed by marine region: "AL" (Alaska waters), "AT" (Atlantic Ocean), "GL" (Great Lakes), "GM" (Gulf of Mexico), "PA" (Eastern Pacific and US West Coast), "PI" (Central and Western Pacific). Only regions with an active alert appear, so the map is empty when no marine alert is active. |
| landAlerts | No | Active alerts affecting land zones. |
| totalAlerts | No | Active alerts nationwide across every message status (Actual, Exercise, System, Test, Draft). Can exceed the totalCount of a national nws_search_alerts search, which counts status Actual by default. |
| marineAlerts | No | Active alerts affecting marine zones. landAlerts + marineAlerts = totalAlerts. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only declare readOnlyHint=true. The description adds substantial behavioral context beyond that: counts include every message status including Test and Exercise, so totalAlerts can exceed nws_search_alerts' default Actual totalCount; area counts can sum past totalAlerts because an alert counts once per area its zones fall in; and landAlerts plus marineAlerts equals totalAlerts. This is rich, non-obvious operational detail.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The definition is dense but front-loaded: the first sentence states purpose, scope, and output size. Subsequent sentences explain non-obvious count semantics and route the agent to the sibling tool for filtered cases. Every sentence adds distinct value with no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so the description need not document return fields. Given the tool takes no parameters, the description covers everything an agent needs: what it counts, what is included, how counts relate to nws_search_alerts, and when to use the alternative.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters, so the schema is empty and the baseline is 4. The description reinforces this with 'Takes no filters,' which is useful but consistent with the empty schema and additionalProperties=false.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: 'Count active weather alerts nationwide, per state/territory or marine area, and per marine region, in one small response.' It distinguishes itself from siblings by specifying that it answers 'how many alerts are active, and where' without fetching the alerts themselves, and it explicitly points to nws_search_alerts for filtered counts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives explicit when-to-use guidance ('the answer to ... without fetching the alerts themselves') and when-not/alternative guidance ('Takes no filters. For counts per zone or under a filter, call nws_search_alerts with that zone or filter and read its totalCount'). An agent knows exactly which tool to choose and when.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_forecastNws Get ForecastBRead-onlyInspect
Get the weather forecast for a US location. Returns either named 12-hour periods (default) or hourly breakdowns.
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque continuation token from a previous response's nextCursor, to retrieve the next 48 periods. Omit for the first page. The token carries the mode it was issued in (hourly or 7-day), so the next page stays in that mode whatever hourly is set to. Every call re-fetches the forecast, so consecutive periods are contiguous within one response; NWS reissues forecasts through the day, so a later call can window a regenerated period array. | |
| hourly | No | If true, returns hourly forecast (48 one-hour periods per page, ~156 available) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity. Sets the mode of the first page; a cursor carries its own mode, so this is ignored when cursor is set. | |
| latitude | Yes | Latitude in decimal degrees (e.g., 47.6062). | |
| longitude | Yes | Longitude in decimal degrees (e.g., -122.3321). | |
| include_amounts | No | Include every native quantitativePrecipitation, snowfallAmount, and iceAccumulation interval from the NWS grid. Applies to this call only, including cursor pages; units and interval strings remain as NWS sends them. Unavailable amounts are explained in notice while the forecast remains available. |
Output Schema
| Name | Required | Description |
|---|---|---|
| mode | No | Forecast mode: "hourly" or "7-day" |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Number of forecast periods in this page (at most 48). |
| notice | No | Guidance when forecast data was last updated more than 24 hours ago, periods remain or the cursor points past the end, or requested amount data or layers are unavailable. |
| periods | No | Forecast periods |
| location | No | Resolved location metadata |
| nextCursor | No | Opaque token for the next page of periods — pass it back as `cursor`; it carries this forecast mode (hourly or 7-day). Omitted when this is the last page. |
| totalCount | No | Total forecast periods available upstream before the page window was applied — NOT the number in this page, which is shown. Compare it against shown to tell whether periods were withheld. |
| updateTime | No | When the data this forecast was generated from was last updated (ISO 8601, as NWS sends it). A grid that stops updating keeps this time while generatedAt keeps advancing. Null when NWS omits it. |
| generatedAt | No | When NWS generated this response (ISO 8601). It advances whenever NWS regenerates the response, even when the underlying data is unchanged; see updateTime for the data age. |
| amountsUpdateTime | No | Native grid updateTime, distinct from forecast updateTime; null when omitted upstream and absent when amounts were not fetched |
| precipitationAmounts | No | Present grid amount layers when requested and fetched successfully; missing layers are named in notice |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
readOnlyHint=true already declares this is a safe read, so the lower bar applies. The description adds only that results come back as named 12-hour periods by default, which does not disclose pagination, error behavior for out-of-coverage points, or whether the tool resolves the NWS grid point internally.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the purpose and then the output-shape distinction. Nothing is repeated from the schema and there is no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need no explanation, and every parameter is documented in the schema. The "US location" caveat is a useful boundary, but the description is silent on what happens outside NWS coverage and on the relationship to zone-based forecasting.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the schema already explains cursor, hourly, coordinates, and include_amounts in depth. The description adds no parameter meaning beyond that, so the baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ("Get the weather forecast") and scopes it to a "US location," while naming the two output shapes (12-hour periods vs hourly). It does not explicitly contrast with the sibling nws_get_zone_forecast, so an agent must infer that this one takes lat/lon while the sibling takes zones.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no when-to-use guidance, no prerequisites, and names no alternative among the nine siblings (e.g., nws_get_zone_forecast, nws_get_observations, nws_get_observation_history). The only choice hinted at, hourly vs 12-hour, is a mode of this tool rather than a reason to pick it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_observation_historyNws Get Observation HistoryARead-onlyInspect
Get a station's recent observation history, newest first — the trend behind the single latest reading nws_get_observations returns (is pressure falling, is the wind picking up). NWS keeps about the last 7 days per station, and a busy airport station reports as often as every 5 minutes, so a day can run past 100 observations: narrow with start (inclusive) and end (exclusive), and page back to older observations with nextCursor. Takes a station ID; use nws_find_stations to find one near a coordinate.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Time to stop before (exclusive), in the same format as start. Omit to start from the most recent observation. | |
| limit | No | Observations per page, newest first. A page holds at most 100; a larger limit (up to 10000) is served as 100 and reported through requestedLimit and effectiveLimit. When older observations remain in the window, the response carries nextCursor; pass it back as cursor for them. | |
| start | No | Earliest observation time to include (inclusive), as an ISO 8601 date-time with seconds and an offset (e.g., "2026-09-30T00:00:00Z" or "2026-09-29T17:00:00-07:00"). Omit to reach back as far as NWS keeps, about 7 days. | |
| cursor | No | Opaque continuation token from a previous response's nextCursor. Omit for the first page. It carries that query's start, end, and applied limit, so those inputs apply to the first page only. Each page continues from just before the oldest observation of the one before it, so pages neither repeat nor skip an observation. | |
| station_id | Yes | Observation station ID (e.g., "KSEA"), case-insensitive. Use nws_find_stations to discover station IDs near a coordinate. |
Output Schema
| Name | Required | Description |
|---|---|---|
| cap | No | The page limit this page holds, when truncated is true |
| error | No | Present when the call failed. Absent on success. |
| shown | No | Number of observations returned in this page |
| notice | No | Guidance when the requested limit exceeded the page cap, when the window held no observations (NWS keeps about the last 7 days), or when older observations remain beyond this page. |
| timeZone | No | Station time zone when known |
| stationId | No | Observation station ID, uppercased |
| truncated | No | True when older observations remain in the window past this page; continue with nextCursor. |
| nextCursor | No | Opaque token for the next, older page — pass it back as cursor. Present only when older observations remain in the window; omitted on the last page. |
| stationName | No | Station name |
| observations | No | Observations in the window, newest first |
| effectiveLimit | No | The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap. |
| requestedLimit | No | The limit asked for, when it exceeded the 100-observation page cap; absent otherwise. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only declare readOnlyHint; the description adds substantive behavioral context beyond that: ~7-day server-side retention, station reporting cadence of roughly 5 minutes, the 100-per-day-scale volume, and that nextCursor pages strictly could continue without repeats or gaps. These are data-availability and paging traits an agent cannot infer from annotations or schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with purpose, then usage, then parameter guidance, with no filler sentences. It is fairly dense and restates some pagination/limit mechanics the schema already covers, which is minor redundancy rather than waste.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Output schema exists, so return values need not be explained; the description instead covers what the schema cannot — retention window, reporting frequency, volume expectations, and how paging composes the result. Nothing needed to call this correctly is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so start/end inclusivity, limit caps, and cursor opacity are already documented in the schema; the description mostly corroborates those (inclusive start, exclusive end, nextCursor). It adds the operational reason to narrow a window (100+ observations per busy day) but no new syntax or format meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get a station's recent observation history, newest first') and explicitly contrasts it with the sibling nws_get_observations ('the trend behind the single latest reading'). An agent can distinguish history-listing from latest-reading without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Names both alternatives and their selection conditions: nws_get_observations for the single latest reading, nws_find_stations to discover station IDs near a coordinate. It also gives concrete narrowing advice ('narrow with start... and end') when a day exceeds 100 observations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_observationsNws Get ObservationsARead-onlyInspect
Get current weather observations (actual measured conditions). Accepts coordinates (resolves nearest station automatically) or a station ID directly (e.g., "KSEA").
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | No | Latitude for automatic station resolution. Use with longitude. Ignored if station_id is provided. | |
| longitude | No | Longitude for automatic station resolution. Use with latitude. Ignored if station_id is provided. | |
| station_id | No | Station identifier directly (e.g., "KSEA", "KORD"). Use nws_find_stations to discover station IDs. |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| notice | No | Guidance when the latest observation is more than 2 hours old or most measurements are unavailable from this station. |
| station | No | Station ID that served the observation (e.g., "KSEA") |
| timeZone | No | Station time zone when known |
| dewpointC | No | Dewpoint in Celsius, to one decimal |
| stationId | No | Observation station ID |
| timestamp | No | Observation time (ISO 8601) |
| heatIndexC | No | Heat index in Celsius, to one decimal |
| observedAt | No | Observation timestamp (ISO 8601) |
| windChillC | No | Wind chill in Celsius, to one decimal |
| cloudLayers | No | Cloud layer information |
| stationName | No | Station name |
| visibilityM | No | Visibility in meters |
| windGustKmh | No | Wind gust in km/h |
| temperatureC | No | Temperature in Celsius, to one decimal (e.g., 8.3) |
| windSpeedKmh | No | Wind speed in km/h |
| textDescription | No | Conditions summary (e.g., "Mostly Cloudy") |
| windDirectionDeg | No | Wind direction in degrees (0-360) |
| relativeHumidityPct | No | Relative humidity in percent (0-100) |
| barometricPressurePa | No | Barometric pressure in Pascals |
| precipitationLastHourMm | No | Precipitation in the past hour in mm, to 0.1 mm. 0 is a trace (under 0.01 in), not a dry hour; null means no amount was reported, the usual value for a dry hour and on 5-minute reports. |
| precipitationLast3HoursMm | No | Precipitation in the past 3 hours in mm, to 0.1 mm, carried by the hourly reports nearest 03, 09, 15, and 21 UTC. 0 is a trace (under 0.01 in); null means no amount was reported. |
| precipitationLast6HoursMm | No | Precipitation in the past 6 hours in mm, to 0.1 mm, carried by the hourly reports nearest 00, 06, 12, and 18 UTC. 0 is a trace (under 0.01 in); null means no amount was reported. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With readOnlyHint=true already covering safety, the description adds useful behavioral context: coordinates are automatically resolved to the nearest station, and a station ID can be supplied directly. It does not contradict the annotations and does not need to explain return values because an output schema exists.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two tight sentences. It front-loads the core purpose and then states the accepted input modes efficiently, with no wasted wording.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-only observation retrieval tool with full schema coverage and an output schema, the description covers purpose and invocation modes well. A slightly more explicit comparison with observation-history and forecast tools would make it complete, but the essential context is present.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents latitude, longitude, station_id, their ranges, and precedence behavior. The description reinforces the coordinate-vs-station-ID choice but does not add much semantic detail beyond the structured schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: getting current weather observations, explicitly characterized as actual measured conditions. That wording distinguishes this tool from forecast-oriented siblings and from historical observation tools without requiring the agent to infer it.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly explains the two invocation modes: coordinates for automatic nearest-station resolution, or a direct station ID such as KSEA. It does not explicitly name when to prefer nws_get_observation_history or nws_get_forecast, but the 'current' and 'measured' framing gives strong implied guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_office_discussionNws Get Office DiscussionARead-onlyInspect
Get the latest narrative forecast product from a Weather Forecast Office (WFO). The default product is AFD (Area Forecast Discussion), which explains the meteorological reasoning behind the forecast — synoptic setup, model guidance, and forecaster confidence. Other types: HWO (Hazardous Weather Outlook, 1-7 day severe/flood/winter outlook), ZFP (Zone Forecast Product, zone-by-zone text), SPS (Special Weather Statement, short-fuse advisory), FWF (Fire Weather Planning Forecast, one segment per fire weather zone). The office code is the 3-letter WFO identifier returned as the "office" field by nws_get_forecast. A product over 24,000 bytes (most ZFPs and FWFs) comes back as an outline of its sections — AFD section names, or ZFP/HWO/SPS/FWF zone segments with their area names — with each section's size, instead of the text; re-call with sections to get the ones you need. sections also works on a product of any size, to read one AFD section or one zone's forecast. For an alert zone typed "fire" (Red Flag Warning, Fire Weather Watch), pass the alert's "office" field as office, product_type "FWF", and the zone code in sections.
| Name | Required | Description | Default |
|---|---|---|---|
| office | Yes | Product location code of 2–3 letters or digits, case-insensitive — usually the 3-letter Weather Forecast Office (WFO) code (e.g., "SEW" for Seattle, "LOX" for Los Angeles), returned as the "office" field in nws_get_forecast output. Some offices file a product under other codes: Anchorage files its ZFP under "AER" (Anchorage East) and "ALU" (Anchorage West), not "AFC"; San Juan files its ZFP under "PR", and Guam its SPS under "PQ1". | |
| sections | No | Sections to return instead of the whole product: AFD section names, case-insensitive (e.g., "DISCUSSION", "AVIATION"), or zone codes for ZFP/HWO/SPS/FWF (e.g., "WAZ315"; a code inside a listed range such as FLZ076>078 selects that segment). Take names from the outline. Returns the product header plus every matching section verbatim, in product order, followed by the product's closing lines (forecaster credits, links). Omit for the whole product, or its outline when it is too large. | |
| product_type | No | Product type code. AFD (Area Forecast Discussion) — meteorological reasoning, model analysis, forecaster confidence. HWO (Hazardous Weather Outlook) — 1-7 day outlook for severe weather, flooding, winter weather. ZFP (Zone Forecast Product) — detailed zone-by-zone text forecast. SPS (Special Weather Statement) — short-fuse advisory for notable non-warning weather. FWF (Fire Weather Planning Forecast) — fire weather discussion plus a forecast segment per fire weather zone (e.g., humidity and wind); select a zone with sections. | AFD |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| notice | No | Set when the product is outlined (with a worked sections re-call) or when sections selected part of it (how many of how many sections came back). |
| outline | No | Sections of a product too large to inline, largest first. Present only in place of productText. |
| productCode | No | Product type code (e.g., "AFD"). |
| productName | No | Full product name (e.g., "Area Forecast Discussion"). |
| productText | No | Narrative product text as issued by the forecaster: the whole product, or the product header followed by each selected section when sections was given. Absent when outline is returned. |
| issuanceTime | No | When the product was issued (ISO 8601), e.g., "2026-05-30T10:33:00+00:00". |
| issuingOffice | No | Issuing office call sign (e.g., "KSEW"). Includes the K/P prefix, unlike the input office code. |
| wmoCollectiveId | No | WMO collective identifier (e.g., "FXUS66"). Identifies the product family in international message routing. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, and the description adds substantial behavioral detail beyond that: products over 24,000 bytes return an outline rather than full text, sections can be used on any size product, and selected sections return header plus matching sections and closing lines. This is exactly the kind of response-shape behavior an agent needs before calling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with the core action and default product, then proceeds through product types and the large-product outline behavior. It is dense but mostly earns its length, though some product-type definitions overlap with the enum descriptions in the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be fully explained, and annotations cover the safety profile. The description still covers the complex parts an agent needs: product-type meanings, office-code sourcing, large-response outlining, section selection, and the fire-weather special case.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3, but the description adds meaningful cross-parameter semantics: office is usually the WFO code from nws_get_forecast, sections can target AFD section names or zone codes, and the fire workflow ties office, product_type, and sections together. It adds value beyond the schema descriptions without fully re-documenting every parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: get the latest narrative forecast product from a WFO. It distinguishes the default AFD from HWO, ZFP, SPS, and FWF, and names the office-code source from nws_get_forecast, so an agent can tell what this tool is for without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives clear context for selecting product types and explicitly routes the fire-weather alert case to product_type FWF with the zone in sections. However, it does not directly contrast this tool with sibling nws_get_zone_forecast or give broader when-not guidance beyond the product-type distinctions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_get_zone_forecastNws Get Zone ForecastARead-onlyInspect
Get the text forecast for an 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" have no text forecast upstream and will not resolve. An entry typed "fire" has its forecast in a segment of the office's Fire Weather Planning Forecast: call nws_get_office_discussion with office set to the alert's "office" field, product_type "FWF", and sections set to the zone code; a fire zone code that is also a public zone code (e.g., "NDZ040") returns that public zone's forecast here, not the fire weather forecast. Marine forecast zones vary: many coastal zones serve a text forecast of wind and seas (e.g., "PZZ251"), while offshore zones (e.g., "GMZ056") and some coastal ones have none. Zone codes follow the pattern XXZ### (e.g., "WAZ315" for the City of Seattle).
| Name | Required | Description | Default |
|---|---|---|---|
| zone_id | Yes | NWS forecast zone code (e.g., "WAZ315" for the City of Seattle, or a marine zone such as "PZZ251"). 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 or marine area code + "Z" + three-digit number. |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| zoneId | No | Zone ID, uppercased (e.g., "WAZ315" for input "waz315"). |
| periods | No | Forecast periods in chronological order, typically covering 7 days. |
| updated | No | When the zone forecast was last updated (ISO 8601 with timezone offset). |
| periodCount | No | Number of forecast periods returned. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only declare readOnlyHint=true; the description goes well beyond by disclosing failure modes (county types will not resolve, offshore marine zones have none), a subtle aliasing behavior (a fire zone code that is also a public zone returns the public forecast here), and the shape of returned periods. This is real behavioral context an agent could not infer from the structured fields.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with purpose, and nearly every sentence carries routing or failure-mode information. It is a single dense block of roughly 180 words with no structural breaks, which makes the fire-zone detour harder to scan than it needs to be, but there is little filler to cut.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter tool with an output schema already describing return values, the description covers everything else an agent needs: valid code sourcing, silent-non-resolution cases, marine variability, and alternative routing for fire zones. Nothing material is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3; the description earns above that by documenting where the zone_id value comes from in the sibling tools' output and by distinguishing zone classes that are syntactically valid but semantically unusable. It does not add format detail beyond the schema's pattern and example, which keeps it from a 5.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Opens with a specific verb and resource ("Get the text forecast for an NWS forecast zone") and immediately characterizes the return as named periods with narrative text. This clearly separates it from nws_get_forecast (point forecast), nws_get_office_discussion (office product text), and the alert/station siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly tells the agent how to obtain valid zone codes (affectedZones entries typed "forecast", or the "forecastZone" column from nws_find_stations), and states exclusions: "county" entries never resolve, "fire" entries must go through nws_get_office_discussion with product_type "FWF". Even the ambiguity of dual-purpose fire/public codes is called out with a concrete example.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_list_alert_typesNws List Alert TypesARead-onlyInspect
List all valid NWS alert event type names. Use to discover valid values for the event filter in nws_search_alerts, or to browse alert categories. No parameters required.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| count | No | Number of event types |
| error | No | Present when the call failed. Absent on success. |
| eventTypes | No | Alert event type names sorted alphabetically |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The readOnlyHint annotation already signals that this is a safe read operation. The description adds the specific behavioral context that the tool returns a list of alert type names, which is beyond the annotation's binary read-only signal. While it does not mention rate limits or authentication, those are not critical for a simple listing tool, and the annotation covers safety.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three short, purposeful sentences. The first states the core action, the second gives usage context, and the third clarifies the lack of parameters. There is no fluff or redundancy, and the most important detail is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a parameterless, read-only list tool, the description is complete. It explains what the tool returns (alert event type names), why it is used (to feed the event filter in nws_search_alerts or to browse), and that it requires no inputs. The output schema (present but not shown) would cover return format details, so nothing is missing from the description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With zero parameters, the rubric sets a baseline of 4. The description's note 'No parameters required' reinforces what the empty schema already implies but does not contradict it. There is nothing more to explain about params since none exist.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource: 'List all valid NWS alert event type names.' It clearly distinguishes this tool from siblings by stating its purpose is to provide valid values for the event filter in nws_search_alerts. This removes any ambiguity about what the tool does and its place among the sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to use the tool: 'Use to discover valid values for the event filter in nws_search_alerts, or to browse alert categories.' It gives a clear primary use case tied to a sibling tool, and a secondary browsing use, leaving no doubt about when an agent should invoke it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
nws_search_alertsNws Search AlertsARead-onlyInspect
Search active weather alerts (watches, warnings, advisories) across the US. Filter by state, coordinates, zone, land/marine region, event type, severity, urgency, or certainty. area, point, zone, region_type, and region are mutually exclusive — provide at most one. Omit all filters for a national search.
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | US state/territory code (e.g., "WA", "OK", "PR") or marine area code (e.g., "GM"). Mutually exclusive with point and zone. | |
| zone | No | NWS forecast zone (e.g., "WAZ558") or county zone (e.g., "WAC033"). Mutually exclusive with area and point. | |
| event | No | Filter to specific event types (e.g., ["Tornado Warning"]). Matches are case-insensitive and partial, so "tornado" matches both "Tornado Warning" and "Tornado Watch". Use nws_list_alert_types to discover valid names. | |
| limit | No | Maximum number of alerts to include in this page (default 25). A page holds at most 25; a larger limit (up to 10000) is served as 25 and reported through requestedLimit and effectiveLimit. totalCount still reports the full number of distinct matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest. | |
| point | No | Coordinates as "lat,lon" (e.g., "47.6,-122.3"). Returns alerts whose geometry contains this point. Mutually exclusive with area and zone. | |
| cursor | No | Opaque continuation token from a previous response's nextCursor; send it on its own. Omit for the first page. It carries that query's filters and page size, so the filter inputs and limit apply to the first page only. Every call re-fetches the active-alert feed, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment. | |
| region | No | Restrict to NWS marine region groups: "AL" (Alaska waters), "AT" (Atlantic Ocean), "GL" (Great Lakes), "GM" (Gulf of Mexico), "PA" (Eastern Pacific and US West Coast), "PI" (Central and Western Pacific). Marine alerts only — a land alert never matches. Mutually exclusive with area, point, zone, and region_type. | |
| status | No | Alert status filter. Default "Actual". Use a different value only when you specifically need non-live alerts. | Actual |
| urgency | No | Filter by urgency level. | |
| severity | No | Filter by severity level. | |
| certainty | No | Filter by certainty level. | |
| region_type | No | Restrict to land-based or marine alerts. Mutually exclusive with area, point, zone, and region. |
Output Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| shown | No | Number of alerts included in this response |
| alerts | No | Matching alerts for this page (at most the applied limit, which never exceeds 25) |
| notice | No | Guidance when the requested limit exceeded the page cap, when no alerts matched (echoes applied filters and suggests how to broaden), when matches remain beyond this page, or when the supplied cursor points past the end of the match set. |
| nextCursor | No | Opaque token for the next page of matches — pass it back as `cursor` on its own; it carries this query's filters and page size. Omitted when this is the last page. |
| totalCount | No | Total distinct alerts matching the filters in this fetch, before the page window is applied. NWS repeats some alerts verbatim within one response; the copies are collapsed on id, so this counts each alert once. Compare against shown to tell whether matches were withheld from this page. |
| appliedFilters | No | Summary of applied search filters |
| effectiveLimit | No | The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap. |
| requestedLimit | No | The limit asked for, when it exceeded the 25-alert page cap; absent otherwise. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With readOnlyHint=true already declared, the description adds the key behavioral fact that results are limited to *active* alerts, and that the location filter family is exclusive. It does not mention pagination cost or feed volatility (the cursor/limit params carry that), so it adds real context without fully carrying the load.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, front-loaded with purpose then constraints then default. No filler and nothing an agent needs to scan for.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 12-parameter optional-filter tool with full schema coverage, an output schema, and annotations, the description covers purpose, exclusivity, and the no-filter case. The pagination/digest behavior and event-name discovery live in param descriptions rather than the main text, which is acceptable but leaves the top-level slightly thin for broad national searches.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds a cross-parameter rule (five mutually exclusive location filters, at most one) that is only partially visible in the per-property descriptions, plus the zero-filter default — genuine semantic value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Search active weather alerts') plus scope (watches, warnings, advisories; across the US) and enumerates the filter dimensions. This clearly separates it from nws_get_alert (single alert), nws_get_alert_counts (aggregates), and nws_list_alert_types (vocabulary).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives explicit selection rules for the competing location filters ('mutually exclusive — provide at most one') and a default action ('Omit all filters for a national search'). It stops short of naming sibling tools like nws_get_alert or nws_find_stations as alternatives for non-search needs, but the when-to-use context is clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
- Changed
nws_get_forecast4 fields changed- added
Input schema / properties / include_amountsAdded value: +{ + "default": false, + "description": "Include every native quantitativePrecipitation, snowfallAmount, and iceAccumulation interval from the NWS grid. Applies to this call only, including cursor pages; units and interval strings remain as NWS sends them. Unavailable amounts are explained in notice while the forecast remains available.", + "type": "boolean" +} - added
Output schema / properties / amountsUpdateTimeAdded value: +{ + "description": "Native grid updateTime, distinct from forecast updateTime; null when omitted upstream and absent when amounts were not fetched", + "type": [ + "string", + "null" + ] +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Set when the forecast data was last updated more than 24 hours ago (giving its age in hours), when periods remain beyond this page, or when the supplied cursor points past the end of the period array."New value: +"Guidance when forecast data was last updated more than 24 hours ago, periods remain or the cursor points past the end, or requested amount data or layers are unavailable." - added
Output schema / properties / precipitationAmountsAdded value: +{ + "description": "Present grid amount layers when requested and fetched successfully; missing layers are named in notice", + "items": { + "additionalProperties": false, + "description": "One present quantitative amount layer", + "properties": { + "layer": { + "description": "Native grid amount layer name", + "enum": [ + "quantitativePrecipitation", + "snowfallAmount", + "iceAccumulation" + ], + "type": "string" + }, + "uom": { + "description": "Native NWS layer unit, or null when omitted", + "type": [ + "string", + "null" + ] + }, + "values": { + "description": "Every interval in this layer, including null measurements; empty when NWS publishes no intervals", + "items": { + "additionalProperties": false, + "description": "One native accumulation interval", + "properties": { + "validTime": { + "description": "Native ISO 8601 interval string, unchanged", + "type": "string" + }, + "value": { + "description": "Native amount, or null when unreported", + "type": [ + "number", + "null" + ] + } + }, + "required": [ + "validTime", + "value" + ], + "type": "object" + }, + "type": "array" + } + }, + "required": [ + "layer", + "uom", + "values" + ], + "type": "object" + }, + "type": "array" +}
- Changed
nws_get_observations1 field changed- changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when the latest observation is more than 2 hours old — data may not reflect current conditions."New value: +"Guidance when the latest observation is more than 2 hours old or most measurements are unavailable from this station."
6 tool updates
- Changed
nws_get_alert7 fields changed- changed
Output schema / properties / alert / properties / affectedZones / items / properties / type / descriptionPrevious value: -"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). Only \"forecast\" codes have a zone text forecast — pass those to nws_get_zone_forecast. All types are valid values for the nws_search_alerts zone filter."New value: +"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). A \"forecast\" code has a zone text forecast: pass it to nws_get_zone_forecast. A \"fire\" code has a segment in its office's Fire Weather Planning Forecast: call nws_get_office_discussion with office from this alert's office field, product_type \"FWF\", and sections [code]. All types are valid values for the nws_search_alerts zone filter." - added
Output schema / properties / alert / properties / hazardAdded value: +{ + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "eventMotionDescription": { + "description": "Storm time, motion, and position in NWS encoding (e.g., \"2026-10-22T17:17:00-00:00...storm...222DEG...11KT...34.0,-118.1\")", + "type": "string" + }, + "flashFloodDamageThreat": { + "description": "Flash flood damage-threat tag (e.g., \"CONSIDERABLE\")", + "type": "string" + }, + "flashFloodDetection": { + "description": "Flash flood detection (e.g., \"RADAR INDICATED\", \"OBSERVED\", \"RADAR AND GAUGE INDICATED\")", + "type": "string" + }, + "hailThreat": { + "description": "How the hail is known (e.g., \"RADAR INDICATED\", \"OBSERVED\")", + "type": "string" + }, + "maxHailSize": { + "description": "Maximum hail size in inches, as NWS states it (e.g., \"1.00\", \"Up to .75\")", + "type": "string" + }, + "maxWindGust": { + "description": "Maximum wind gust, as NWS states it (e.g., \"60 MPH\", \"34 knots\")", + "type": "string" + }, + "thunderstormDamageThreat": { + "description": "Thunderstorm damage-threat tag (e.g., \"CONSIDERABLE\")", + "type": "string" + }, + "tornadoDamageThreat": { + "description": "Tornado damage-threat tag", + "type": "string" + }, + "tornadoDetection": { + "description": "Tornado detection (e.g., \"RADAR INDICATED\", \"POSSIBLE\")", + "type": "string" + }, + "waterspoutDetection": { + "description": "Waterspout detection (e.g., \"POSSIBLE\")", + "type": "string" + }, + "windThreat": { + "description": "How the wind is known (e.g., \"RADAR INDICATED\", \"OBSERVED\")", + "type": "string" + } + }, + "type": "object" + }, + { + "type": "null" + } + ], + "description": "Severe-weather tags NWS attaches, under NWS key names with values verbatim (free text such as \"Up to .75\" or \"34 knots\"). Only the tags NWS sent are present; null when it sent none." +} - added
Output schema / properties / alert / properties / nwsHeadlineAdded value: +{ + "description": "The NWS product headline (e.g., \"RED FLAG WARNING IN EFFECT FROM NOON TO 8 PM MDT FRIDAY\"), distinct from headline; null when NWS sends none.", + "type": [ + "string", + "null" + ] +} - added
Output schema / properties / alert / properties / officeAdded value: +{ + "description": "Issuing forecast office code (e.g., \"RIW\"), from the issuing centre in the message's WMO header; pass it as office to nws_get_office_discussion. Null for tsunami warning centres and national test messages, which have no office discussion, and when NWS sends no usable WMO header.", + "type": [ + "string", + "null" + ] +} - changed
Output schema / properties / alert / properties / senderName / descriptionPrevious value: -"Issuing office"New value: +"Issuing office name (e.g., \"NWS Riverton WY\"); the office code nws_get_office_discussion takes is in office" - added
Output schema / properties / alert / properties / vtecAdded value: +{ + "description": "Raw P-VTEC strings NWS attaches (e.g., \"/O.CON.KRIW.FW.W.0031.261023T1800Z-261024T0200Z/\"), the key that tracks one event across its updates; empty when NWS sends none (e.g., Special Weather Statements).", + "items": { + "description": "One P-VTEC string, verbatim", + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / alert / requiredPrevious value: -[ - "id", - "event", - "headline", - "description", - "instruction", - "severity", - "urgency", - "certainty", - "areaDesc", - "sent", - "effective", - "onset", - "ends", - "expires", - "status", - "messageType", - "references", - "senderName", - "affectedZones" -]New value: +[ + "id", + "event", + "headline", + "description", + "instruction", + "severity", + "urgency", + "certainty", + "areaDesc", + "sent", + "effective", + "onset", + "ends", + "expires", + "status", + "messageType", + "references", + "senderName", + "office", + "vtec", + "nwsHeadline", + "hazard", + "affectedZones" +]
- Changed
nws_get_forecast7 fields changed- changed
Input schema / properties / cursor / descriptionPrevious value: -"Opaque continuation token from a previous response's nextCursor, to retrieve the next 48 periods. Omit for the first page. Every call re-fetches the forecast, so consecutive periods are contiguous within one response; NWS reissues forecasts through the day, so a later call can window a regenerated period array."New value: +"Opaque continuation token from a previous response's nextCursor, to retrieve the next 48 periods. Omit for the first page. The token carries the mode it was issued in (hourly or 7-day), so the next page stays in that mode whatever hourly is set to. Every call re-fetches the forecast, so consecutive periods are contiguous within one response; NWS reissues forecasts through the day, so a later call can window a regenerated period array." - changed
Input schema / properties / hourly / descriptionPrevious value: -"If true, returns hourly forecast (48 one-hour periods per page, ~156 available) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity."New value: +"If true, returns hourly forecast (48 one-hour periods per page, ~156 available) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity. Sets the mode of the first page; a cursor carries its own mode, so this is ignored when cursor is set." - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "location", - "generatedAt", - "periods", - "totalCount", - "shown", - "mode" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "location", + "generatedAt", + "updateTime", + "periods", + "totalCount", + "shown", + "mode" + ] + }, + { + "required": [ + "error" + ] + } +] - changed
Output schema / properties / generatedAt / descriptionPrevious value: -"When the forecast was generated (ISO 8601)"New value: +"When NWS generated this response (ISO 8601). It advances whenever NWS regenerates the response, even when the underlying data is unchanged; see updateTime for the data age." - changed
Output schema / properties / nextCursor / descriptionPrevious value: -"Opaque token for the next page of periods — pass it back as `cursor`. Omitted when this is the last page."New value: +"Opaque token for the next page of periods — pass it back as `cursor`; it carries this forecast mode (hourly or 7-day). Omitted when this is the last page." - changed
Output schema / properties / notice / descriptionPrevious value: -"Set when periods remain beyond this page, or when the supplied cursor points past the end of the period array."New value: +"Set when the forecast data was last updated more than 24 hours ago (giving its age in hours), when periods remain beyond this page, or when the supplied cursor points past the end of the period array." - added
Output schema / properties / updateTimeAdded value: +{ + "description": "When the data this forecast was generated from was last updated (ISO 8601, as NWS sends it). A grid that stops updating keeps this time while generatedAt keeps advancing. Null when NWS omits it.", + "type": [ + "string", + "null" + ] +}
- Changed
nws_get_observation_history8 fields changed- changed
Output schema / properties / observations / items / properties / dewpointC / descriptionPrevious value: -"Dewpoint in Celsius"New value: +"Dewpoint in Celsius, to one decimal" - changed
Output schema / properties / observations / items / properties / heatIndexC / descriptionPrevious value: -"Heat index in Celsius"New value: +"Heat index in Celsius, to one decimal" - added
Output schema / properties / observations / items / properties / precipitationLast3HoursMmAdded value: +{ + "description": "Precipitation in the past 3 hours in mm, to 0.1 mm, carried by the hourly reports nearest 03, 09, 15, and 21 UTC. 0 is a trace (under 0.01 in); null means no amount was reported.", + "type": [ + "number", + "null" + ] +} - added
Output schema / properties / observations / items / properties / precipitationLast6HoursMmAdded value: +{ + "description": "Precipitation in the past 6 hours in mm, to 0.1 mm, carried by the hourly reports nearest 00, 06, 12, and 18 UTC. 0 is a trace (under 0.01 in); null means no amount was reported.", + "type": [ + "number", + "null" + ] +} - added
Output schema / properties / observations / items / properties / precipitationLastHourMmAdded value: +{ + "description": "Precipitation in the past hour in mm, to 0.1 mm. 0 is a trace (under 0.01 in), not a dry hour; null means no amount was reported, the usual value for a dry hour and on 5-minute reports.", + "type": [ + "number", + "null" + ] +} - changed
Output schema / properties / observations / items / properties / temperatureC / descriptionPrevious value: -"Temperature in Celsius"New value: +"Temperature in Celsius, to one decimal (e.g., 8.3)" - changed
Output schema / properties / observations / items / properties / windChillC / descriptionPrevious value: -"Wind chill in Celsius"New value: +"Wind chill in Celsius, to one decimal" - changed
Output schema / properties / observations / items / requiredPrevious value: -[ - "timestamp", - "textDescription", - "temperatureC", - "dewpointC", - "windSpeedKmh", - "windDirectionDeg", - "windGustKmh", - "barometricPressurePa", - "visibilityM", - "relativeHumidityPct", - "heatIndexC", - "windChillC", - "cloudLayers" -]New value: +[ + "timestamp", + "textDescription", + "temperatureC", + "dewpointC", + "windSpeedKmh", + "windDirectionDeg", + "windGustKmh", + "barometricPressurePa", + "visibilityM", + "relativeHumidityPct", + "heatIndexC", + "windChillC", + "precipitationLastHourMm", + "precipitationLast3HoursMm", + "precipitationLast6HoursMm", + "cloudLayers" +]
- Changed
nws_get_observations8 fields changed- changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "stationId", - "stationName", - "timestamp", - "timeZone", - "textDescription", - "temperatureC", - "dewpointC", - "windSpeedKmh", - "windDirectionDeg", - "windGustKmh", - "barometricPressurePa", - "visibilityM", - "relativeHumidityPct", - "heatIndexC", - "windChillC", - "cloudLayers", - "station", - "observedAt" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "stationId", + "stationName", + "timestamp", + "timeZone", + "textDescription", + "temperatureC", + "dewpointC", + "windSpeedKmh", + "windDirectionDeg", + "windGustKmh", + "barometricPressurePa", + "visibilityM", + "relativeHumidityPct", + "heatIndexC", + "windChillC", + "precipitationLastHourMm", + "precipitationLast3HoursMm", + "precipitationLast6HoursMm", + "cloudLayers", + "station", + "observedAt" + ] + }, + { + "required": [ + "error" + ] + } +] - changed
Output schema / properties / dewpointC / descriptionPrevious value: -"Dewpoint in Celsius"New value: +"Dewpoint in Celsius, to one decimal" - changed
Output schema / properties / heatIndexC / descriptionPrevious value: -"Heat index in Celsius"New value: +"Heat index in Celsius, to one decimal" - added
Output schema / properties / precipitationLast3HoursMmAdded value: +{ + "description": "Precipitation in the past 3 hours in mm, to 0.1 mm, carried by the hourly reports nearest 03, 09, 15, and 21 UTC. 0 is a trace (under 0.01 in); null means no amount was reported.", + "type": [ + "number", + "null" + ] +} - added
Output schema / properties / precipitationLast6HoursMmAdded value: +{ + "description": "Precipitation in the past 6 hours in mm, to 0.1 mm, carried by the hourly reports nearest 00, 06, 12, and 18 UTC. 0 is a trace (under 0.01 in); null means no amount was reported.", + "type": [ + "number", + "null" + ] +} - added
Output schema / properties / precipitationLastHourMmAdded value: +{ + "description": "Precipitation in the past hour in mm, to 0.1 mm. 0 is a trace (under 0.01 in), not a dry hour; null means no amount was reported, the usual value for a dry hour and on 5-minute reports.", + "type": [ + "number", + "null" + ] +} - changed
Output schema / properties / temperatureC / descriptionPrevious value: -"Temperature in Celsius"New value: +"Temperature in Celsius, to one decimal (e.g., 8.3)" - changed
Output schema / properties / windChillC / descriptionPrevious value: -"Wind chill in Celsius"New value: +"Wind chill in Celsius, to one decimal"
- Changed
nws_get_office_discussion4 fields changed- changed
Input schema / properties / product_type / descriptionPrevious value: -"Product type code. AFD (Area Forecast Discussion) — meteorological reasoning, model analysis, forecaster confidence. HWO (Hazardous Weather Outlook) — 1-7 day outlook for severe weather, flooding, winter weather. ZFP (Zone Forecast Product) — detailed zone-by-zone text forecast. SPS (Special Weather Statement) — short-fuse advisory for notable non-warning weather."New value: +"Product type code. AFD (Area Forecast Discussion) — meteorological reasoning, model analysis, forecaster confidence. HWO (Hazardous Weather Outlook) — 1-7 day outlook for severe weather, flooding, winter weather. ZFP (Zone Forecast Product) — detailed zone-by-zone text forecast. SPS (Special Weather Statement) — short-fuse advisory for notable non-warning weather. FWF (Fire Weather Planning Forecast) — fire weather discussion plus a forecast segment per fire weather zone (e.g., humidity and wind); select a zone with sections." - changed
Input schema / properties / product_type / enumPrevious value: -[ - "AFD", - "HWO", - "ZFP", - "SPS" -]New value: +[ + "AFD", + "HWO", + "ZFP", + "SPS", + "FWF" +] - changed
Input schema / properties / sections / descriptionPrevious value: -"Sections to return instead of the whole product: AFD section names, case-insensitive (e.g., \"DISCUSSION\", \"AVIATION\"), or zone codes for ZFP/HWO/SPS (e.g., \"WAZ315\"; a code inside a listed range such as FLZ076>078 selects that segment). Take names from the outline. Returns the product header plus every matching section verbatim, in product order, followed by the product's closing lines (forecaster credits, links). Omit for the whole product, or its outline when it is too large."New value: +"Sections to return instead of the whole product: AFD section names, case-insensitive (e.g., \"DISCUSSION\", \"AVIATION\"), or zone codes for ZFP/HWO/SPS/FWF (e.g., \"WAZ315\"; a code inside a listed range such as FLZ076>078 selects that segment). Take names from the outline. Returns the product header plus every matching section verbatim, in product order, followed by the product's closing lines (forecaster credits, links). Omit for the whole product, or its outline when it is too large." - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or no product of the requested type is filed under it: episodic types (SPS, HWO) are commonly empty, and some offices file AFD or ZFP under other location codes. `unknown_section`: A sections entry matches no section of the latest product. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or no product of the requested type is filed under it: episodic types (SPS, HWO) are commonly empty, some offices file AFD or ZFP under other location codes, and some offices issue no FWF. `unknown_section`: A sections entry matches no section of the latest product. Other values are possible when a failure originates below the handler."
- Changed
nws_search_alerts9 fields changed- changed
Input schema / properties / cursor / descriptionPrevious value: -"Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches the active-alert feed, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment."New value: +"Opaque continuation token from a previous response's nextCursor; send it on its own. Omit for the first page. It carries that query's filters and page size, so the filter inputs and limit apply to the first page only. Every call re-fetches the active-alert feed, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment." - changed
Output schema / properties / alerts / items / properties / affectedZones / items / properties / type / descriptionPrevious value: -"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). Only \"forecast\" codes have a zone text forecast — pass those to nws_get_zone_forecast. All types are valid values for the nws_search_alerts zone filter."New value: +"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). A \"forecast\" code has a zone text forecast: pass it to nws_get_zone_forecast. A \"fire\" code has a segment in its office's Fire Weather Planning Forecast: call nws_get_office_discussion with office from this alert's office field, product_type \"FWF\", and sections [code]. All types are valid values for the nws_search_alerts zone filter." - added
Output schema / properties / alerts / items / properties / hazardAdded value: +{ + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "eventMotionDescription": { + "description": "Storm time, motion, and position in NWS encoding (e.g., \"2026-10-22T17:17:00-00:00...storm...222DEG...11KT...34.0,-118.1\")", + "type": "string" + }, + "flashFloodDamageThreat": { + "description": "Flash flood damage-threat tag (e.g., \"CONSIDERABLE\")", + "type": "string" + }, + "flashFloodDetection": { + "description": "Flash flood detection (e.g., \"RADAR INDICATED\", \"OBSERVED\", \"RADAR AND GAUGE INDICATED\")", + "type": "string" + }, + "hailThreat": { + "description": "How the hail is known (e.g., \"RADAR INDICATED\", \"OBSERVED\")", + "type": "string" + }, + "maxHailSize": { + "description": "Maximum hail size in inches, as NWS states it (e.g., \"1.00\", \"Up to .75\")", + "type": "string" + }, + "maxWindGust": { + "description": "Maximum wind gust, as NWS states it (e.g., \"60 MPH\", \"34 knots\")", + "type": "string" + }, + "thunderstormDamageThreat": { + "description": "Thunderstorm damage-threat tag (e.g., \"CONSIDERABLE\")", + "type": "string" + }, + "tornadoDamageThreat": { + "description": "Tornado damage-threat tag", + "type": "string" + }, + "tornadoDetection": { + "description": "Tornado detection (e.g., \"RADAR INDICATED\", \"POSSIBLE\")", + "type": "string" + }, + "waterspoutDetection": { + "description": "Waterspout detection (e.g., \"POSSIBLE\")", + "type": "string" + }, + "windThreat": { + "description": "How the wind is known (e.g., \"RADAR INDICATED\", \"OBSERVED\")", + "type": "string" + } + }, + "type": "object" + }, + { + "type": "null" + } + ], + "description": "Severe-weather tags NWS attaches, under NWS key names with values verbatim (free text such as \"Up to .75\" or \"34 knots\"). Only the tags NWS sent are present; null when it sent none." +} - added
Output schema / properties / alerts / items / properties / nwsHeadlineAdded value: +{ + "description": "The NWS product headline (e.g., \"RED FLAG WARNING IN EFFECT FROM NOON TO 8 PM MDT FRIDAY\"), distinct from headline; null when NWS sends none.", + "type": [ + "string", + "null" + ] +} - added
Output schema / properties / alerts / items / properties / officeAdded value: +{ + "description": "Issuing forecast office code (e.g., \"RIW\"), from the issuing centre in the message's WMO header; pass it as office to nws_get_office_discussion. Null for tsunami warning centres and national test messages, which have no office discussion, and when NWS sends no usable WMO header.", + "type": [ + "string", + "null" + ] +} - changed
Output schema / properties / alerts / items / properties / senderName / descriptionPrevious value: -"Issuing office"New value: +"Issuing office name (e.g., \"NWS Riverton WY\"); the office code nws_get_office_discussion takes is in office" - added
Output schema / properties / alerts / items / properties / vtecAdded value: +{ + "description": "Raw P-VTEC strings NWS attaches (e.g., \"/O.CON.KRIW.FW.W.0031.261023T1800Z-261024T0200Z/\"), the key that tracks one event across its updates; empty when NWS sends none (e.g., Special Weather Statements).", + "items": { + "description": "One P-VTEC string, verbatim", + "type": "string" + }, + "type": "array" +} - changed
Output schema / properties / alerts / items / requiredPrevious value: -[ - "id", - "event", - "headline", - "description", - "instruction", - "severity", - "urgency", - "certainty", - "areaDesc", - "sent", - "effective", - "onset", - "ends", - "expires", - "status", - "messageType", - "references", - "senderName", - "affectedZones" -]New value: +[ + "id", + "event", + "headline", + "description", + "instruction", + "severity", + "urgency", + "certainty", + "areaDesc", + "sent", + "effective", + "onset", + "ends", + "expires", + "status", + "messageType", + "references", + "senderName", + "office", + "vtec", + "nwsHeadline", + "hazard", + "affectedZones" +] - changed
Output schema / properties / nextCursor / descriptionPrevious value: -"Opaque token for the next page of matches — pass it back as `cursor`. Omitted when this is the last page."New value: +"Opaque token for the next page of matches — pass it back as `cursor` on its own; it carries this query's filters and page size. Omitted when this is the last page."
8 tool updates
- Changed
nws_find_stations5 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Max stations per page (1-50). totalCount still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest."New value: +"Max stations per page. A page holds at most 50; a larger limit (up to 10000) is served as 50 and reported through requestedLimit and effectiveLimit. totalCount still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest." - changed
Input schema / properties / limit / maximumPrevious value: -50New value: +10000 - added
Output schema / properties / effectiveLimitAdded value: +{ + "description": "The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap.", + "type": "number" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when no stations were found near the requested coordinates, when stations remain beyond this page, or when the supplied cursor points past the end of the list."New value: +"Guidance when the requested limit exceeded the page cap, when no stations were found near the requested coordinates, when stations remain beyond this page, or when the supplied cursor points past the end of the list." - added
Output schema / properties / requestedLimitAdded value: +{ + "description": "The limit asked for, when it exceeded the 50-station page cap; absent otherwise.", + "type": "number" +}
- Added
nws_get_alert - Changed
nws_get_forecast1 field changed- changed
Output schema / properties / periods / items / properties / name / descriptionPrevious value: -"Period name (e.g., \"Today\", \"Tonight\") or hour label"New value: +"Period name (e.g., \"Today\", \"Tonight\"); in hourly mode, the weekday and start time in the location time zone (e.g., \"Fri 6:00 AM\")"
- Changed
nws_get_observation_history12 fields changed- changed
Input schema / properties / cursor / descriptionPrevious value: -"Opaque continuation token from a previous response's nextCursor. Omit for the first page. It carries that query's start, end, and limit, so those inputs apply to the first page only. Each page continues from just before the oldest observation of the one before it, so pages neither repeat nor skip an observation."New value: +"Opaque continuation token from a previous response's nextCursor. Omit for the first page. It carries that query's start, end, and applied limit, so those inputs apply to the first page only. Each page continues from just before the oldest observation of the one before it, so pages neither repeat nor skip an observation." - added
Input schema / properties / end / patternAdded value: +"^\\s*(?:\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})\\s*)?$" - changed
Input schema / properties / limit / descriptionPrevious value: -"Observations per page (1-100), newest first. When a page fills the limit, pass its nextCursor back as cursor for older observations."New value: +"Observations per page, newest first. A page holds at most 100; a larger limit (up to 10000) is served as 100 and reported through requestedLimit and effectiveLimit. When older observations remain in the window, the response carries nextCursor; pass it back as cursor for them." - changed
Input schema / properties / limit / maximumPrevious value: -100New value: +10000 - added
Input schema / properties / start / patternAdded value: +"^\\s*(?:\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})\\s*)?$" - added
Input schema / properties / station_id / patternAdded value: +"^\\s*[A-Za-z0-9]+\\s*$" - changed
Output schema / properties / cap / descriptionPrevious value: -"The page limit this page filled, when truncated is true"New value: +"The page limit this page holds, when truncated is true" - added
Output schema / properties / effectiveLimitAdded value: +{ + "description": "The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap.", + "type": "number" +} - changed
Output schema / properties / nextCursor / descriptionPrevious value: -"Opaque token for the next, older page — pass it back as cursor. Present only when this page filled the limit; omitted on the last page."New value: +"Opaque token for the next, older page — pass it back as cursor. Present only when older observations remain in the window; omitted on the last page." - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when the window held no observations (NWS keeps about the last 7 days), or when this page filled the limit and older observations may remain."New value: +"Guidance when the requested limit exceeded the page cap, when the window held no observations (NWS keeps about the last 7 days), or when older observations remain beyond this page." - added
Output schema / properties / requestedLimitAdded value: +{ + "description": "The limit asked for, when it exceeded the 100-observation page cap; absent otherwise.", + "type": "number" +} - changed
Output schema / properties / truncated / descriptionPrevious value: -"True when this page filled the limit and older observations in the window may remain; continue with nextCursor."New value: +"True when older observations remain in the window past this page; continue with nextCursor."
- Changed
nws_get_observations1 field changed- added
Input schema / properties / station_id / patternAdded value: +"^\\s*(?:[A-Za-z0-9]+\\s*)?$"
- Changed
nws_get_office_discussion9 fields changed- changed
Input schema / properties / office / descriptionPrevious value: -"Three-letter Weather Forecast Office (WFO) code (e.g., \"SEW\" for Seattle, \"LOX\" for Los Angeles). Returned as the \"office\" field in nws_get_forecast output."New value: +"Product location code of 2–3 letters or digits, case-insensitive — usually the 3-letter Weather Forecast Office (WFO) code (e.g., \"SEW\" for Seattle, \"LOX\" for Los Angeles), returned as the \"office\" field in nws_get_forecast output. Some offices file a product under other codes: Anchorage files its ZFP under \"AER\" (Anchorage East) and \"ALU\" (Anchorage West), not \"AFC\"; San Juan files its ZFP under \"PR\", and Guam its SPS under \"PQ1\"." - added
Input schema / properties / office / patternAdded value: +"^\\s*[A-Za-z0-9]{2,3}\\s*$" - added
Input schema / properties / sectionsAdded value: +{ + "description": "Sections to return instead of the whole product: AFD section names, case-insensitive (e.g., \"DISCUSSION\", \"AVIATION\"), or zone codes for ZFP/HWO/SPS (e.g., \"WAZ315\"; a code inside a listed range such as FLZ076>078 selects that segment). Take names from the outline. Returns the product header plus every matching section verbatim, in product order, followed by the product's closing lines (forecaster credits, links). Omit for the whole product, or its outline when it is too large.", + "items": { + "maxLength": 200, + "type": "string" + }, + "maxItems": 100, + "type": "array" +} - changed
Output schema / anyOfPrevious value: -[ - { - "not": { - "required": [ - "error" - ] - }, - "required": [ - "issuanceTime", - "issuingOffice", - "productCode", - "productName", - "productText", - "wmoCollectiveId" - ] - }, - { - "required": [ - "error" - ] - } -]New value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "issuanceTime", + "issuingOffice", + "productCode", + "productName", + "wmoCollectiveId" + ] + }, + { + "required": [ + "error" + ] + } +] - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or a valid office has no current product of the requested type (episodic types like SPS and HWO are commonly empty). Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or no product of the requested type is filed under it: episodic types (SPS, HWO) are commonly empty, and some offices file AFD or ZFP under other location codes. `unknown_section`: A sections entry matches no section of the latest product. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "no_products" -]New value: +[ + "no_products", + "unknown_section" +] - added
Output schema / properties / noticeAdded value: +{ + "description": "Set when the product is outlined (with a worked sections re-call) or when sections selected part of it (how many of how many sections came back).", + "type": "string" +} - added
Output schema / properties / outlineAdded value: +{ + "description": "Sections of a product too large to inline, largest first. Present only in place of productText.", + "items": { + "additionalProperties": false, + "description": "One section of the product", + "properties": { + "bytes": { + "description": "Size of the section text in bytes.", + "type": "number" + }, + "label": { + "description": "Area name line of a zone segment (e.g., \"City of Seattle\").", + "type": "string" + }, + "name": { + "description": "AFD section name (e.g., \"AVIATION\"), or a zone segment's zone codes as issued, ranges written NNN>MMM (e.g., \"FLZ076>078, IDZ001\"). Pass it, or any one zone code it covers, in sections.", + "type": "string" + } + }, + "required": [ + "name", + "bytes" + ], + "type": "object" + }, + "type": "array" +} - changed
Output schema / properties / productText / descriptionPrevious value: -"Full narrative product text as issued by the forecaster. AFDs are typically 1,000-3,000 words covering synoptic setup, model guidance, and period-by-period reasoning."New value: +"Narrative product text as issued by the forecaster: the whole product, or the product header followed by each selected section when sections was given. Absent when outline is returned."
- Changed
nws_get_zone_forecast3 fields changed- changed
Input schema / properties / zone_id / descriptionPrevious value: -"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."New value: +"NWS forecast zone code (e.g., \"WAZ315\" for the City of Seattle, or a marine zone such as \"PZZ251\"). 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 or marine area code + \"Z\" + three-digit number." - added
Input schema / properties / zone_id / patternAdded value: +"^\\s*[A-Za-z]{2}[Zz]\\d{3}\\s*$" - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `zone_not_found`: Zone code is not a valid public forecast zone. `zone_forecast_unavailable`: Zone is a valid public forecast zone, but NWS has no text forecast for it. `marine_forecast_unsupported`: Zone is a marine forecast zone, for which NWS publishes no text forecast. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `zone_not_found`: Zone code is not a valid NWS forecast zone. `zone_forecast_unavailable`: Zone is a valid land forecast zone, but NWS has no text forecast for it. `marine_forecast_unsupported`: Zone is a marine forecast zone NWS publishes no text forecast for (availability varies by zone). Other values are possible when a failure originates below the handler."
- Changed
nws_search_alerts16 fields changed- added
Input schema / properties / area / patternAdded value: +"^\\s*(?:[A-Za-z]{2}\\s*)?$" - changed
Input schema / properties / limit / descriptionPrevious value: -"Maximum number of alerts to include in this page (1-25, default 25). totalCount still reports the full number of distinct matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest."New value: +"Maximum number of alerts to include in this page (default 25). A page holds at most 25; a larger limit (up to 10000) is served as 25 and reported through requestedLimit and effectiveLimit. totalCount still reports the full number of distinct matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest." - changed
Input schema / properties / limit / maximumPrevious value: -25New value: +10000 - added
Input schema / properties / point / patternAdded value: +"^\\s*(?:(?:-\\s*)?\\d(?:\\s*\\d)*(?:\\s*\\.\\s*\\d(?:\\s*\\d)*)?\\s*,\\s*(?:-\\s*)?\\d(?:\\s*\\d)*(?:\\s*\\.\\s*\\d(?:\\s*\\d)*)?\\s*)?$" - added
Input schema / properties / zone / patternAdded value: +"^\\s*(?:[A-Za-z]{2}[CcZz]\\d{3}\\s*)?$" - changed
Output schema / properties / alerts / descriptionPrevious value: -"Matching alerts for this page (at most the requested limit, max 25)"New value: +"Matching alerts for this page (at most the applied limit, which never exceeds 25)" - changed
Output schema / properties / alerts / items / descriptionPrevious value: -"Single active alert with event, severity, area, and timing"New value: +"Single alert message with event, severity, area, and timing" - changed
Output schema / properties / alerts / items / properties / affectedZones / items / properties / type / descriptionPrevious value: -"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). Only \"forecast\" codes have a zone text forecast — pass those to nws_get_zone_forecast. All types are valid values for this tool's own zone filter."New value: +"NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). Only \"forecast\" codes have a zone text forecast — pass those to nws_get_zone_forecast. All types are valid values for the nws_search_alerts zone filter." - changed
Output schema / properties / alerts / items / properties / id / descriptionPrevious value: -"Alert ID"New value: +"Alert message ID. Pass it unchanged as alert_id to nws_get_alert to fetch this message again." - changed
Output schema / properties / alerts / items / properties / references / descriptionPrevious value: -"Prior alert messages this one supersedes, newest first. Empty for an original issuance — never inferred when NWS reports none."New value: +"Prior alert messages this one supersedes, newest first by sent instant; messages sent at the same instant keep the order NWS lists them in, and one whose sent time does not parse comes last. Empty for an original issuance — never inferred when NWS reports none. nws_get_alert fetches any of them by identifier. Every reference sharing the newest sent time is an immediate predecessor (an update can merge several earlier segments); the first is one of them." - changed
Output schema / properties / alerts / items / properties / references / items / properties / identifier / descriptionPrevious value: -"CAP identifier of the superseded message"New value: +"CAP identifier of the superseded message. Pass it unchanged as alert_id to nws_get_alert to read that message, which carries its own references." - changed
Output schema / properties / alerts / items / properties / status / descriptionPrevious value: -"This alert's own CAP status as reported by NWS (\"Actual\", \"Exercise\", \"System\", \"Test\", \"Draft\"). Distinct from the status input filter, which selects which alerts are searched — with the default filter every returned alert reads \"Actual\"."New value: +"This alert's own CAP status as reported by NWS (\"Actual\", \"Exercise\", \"System\", \"Test\", \"Draft\"). Distinct from the nws_search_alerts status input filter, which selects which alerts a search covers — with that filter at its default, every alert a search returns reads \"Actual\"." - added
Output schema / properties / effectiveLimitAdded value: +{ + "description": "The page size applied instead of requestedLimit; continued pages keep it. Absent when the limit was within the cap.", + "type": "number" +} - changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided. `invalid_area_code`: Area code is not a recognized US state, territory, or marine area. `invalid_point`: Point coordinates are malformed or outside valid bounds. `invalid_zone`: Zone code does not match the NWS zone-code shape. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided. `invalid_area_code`: Area code is not a recognized US state, territory, or marine area. `invalid_point`: Point coordinates are malformed, outside valid bounds, or outside NWS coverage (US states, territories, and adjacent marine areas). `invalid_zone`: Zone code does not match the NWS zone-code shape. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when no alerts matched (echoes applied filters and suggests how to broaden), when matches remain beyond this page, or when the supplied cursor points past the end of the match set."New value: +"Guidance when the requested limit exceeded the page cap, when no alerts matched (echoes applied filters and suggests how to broaden), when matches remain beyond this page, or when the supplied cursor points past the end of the match set." - added
Output schema / properties / requestedLimitAdded value: +{ + "description": "The limit asked for, when it exceeded the 25-alert page cap; absent otherwise.", + "type": "number" +}
6 tool updates
- Added
nws_get_alert_counts - Changed
nws_get_forecast2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. `marine_forecast_unsupported`: Coordinates fall in a marine area, where NWS publishes no point forecast. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. `marine_forecast_unsupported`: Coordinates fall in a marine area, where NWS publishes no point forecast. `no_forecast_grid`: Coordinates are on land in a forecast zone NWS serves no forecast grid for (e.g., interior Northern Mariana Islands). Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "out_of_scope", - "marine_forecast_unsupported" -]New value: +[ + "out_of_scope", + "marine_forecast_unsupported", + "no_forecast_grid" +]
- Added
nws_get_observation_history - Changed
nws_get_observations2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `missing_input`: Neither station_id nor a (latitude, longitude) pair was provided. `blank_station_id`: station_id was provided with a blank value. `station_not_found`: Station ID does not exist in the NWS network. `no_observations`: Station has no recent observations available. `no_stations_nearby`: No observation stations exist near the requested coordinates. `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `missing_input`: Neither station_id nor a (latitude, longitude) pair was provided. `station_not_found`: Station ID does not exist in the NWS network. `no_observations`: Station has no recent observations available. `no_stations_nearby`: No observation stations exist near the requested coordinates. `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "missing_input", - "blank_station_id", - "station_not_found", - "no_observations", - "no_stations_nearby", - "out_of_scope" -]New value: +[ + "missing_input", + "station_not_found", + "no_observations", + "no_stations_nearby", + "out_of_scope" +]
- Changed
nws_get_zone_forecast1 field changed- changed
Output schema / properties / zoneId / descriptionPrevious value: -"Zone ID as provided (e.g., \"WAZ315\")."New value: +"Zone ID, uppercased (e.g., \"WAZ315\" for input \"waz315\")."
- Changed
nws_search_alerts2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided. `invalid_area_code`: Area code is not a recognized US state, territory, or marine area. `invalid_point`: Point coordinates are malformed or outside valid bounds. `invalid_zone`: Zone code does not match the NWS zone-code shape. `blank_location_filter`: An area, point, or zone filter was provided with a blank value. `empty_filter_array`: An event, severity, urgency, certainty, or region filter was provided with no usable entries. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided. `invalid_area_code`: Area code is not a recognized US state, territory, or marine area. `invalid_point`: Point coordinates are malformed or outside valid bounds. `invalid_zone`: Zone code does not match the NWS zone-code shape. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "mutually_exclusive_filters", - "invalid_area_code", - "invalid_point", - "invalid_zone", - "blank_location_filter", - "empty_filter_array" -]New value: +[ + "mutually_exclusive_filters", + "invalid_area_code", + "invalid_point", + "invalid_zone" +]
2 tool updates
- Changed
nws_get_forecast2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. `marine_forecast_unsupported`: Coordinates fall in a marine area, where NWS publishes no point forecast. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "out_of_scope" -]New value: +[ + "out_of_scope", + "marine_forecast_unsupported" +]
- Changed
nws_get_zone_forecast2 fields changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"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."New value: +"Machine-readable failure mode. Declared by this tool: `zone_not_found`: Zone code is not a valid public forecast zone. `zone_forecast_unavailable`: Zone is a valid public forecast zone, but NWS has no text forecast for it. `marine_forecast_unsupported`: Zone is a marine forecast zone, for which NWS publishes no text forecast. Other values are possible when a failure originates below the handler." - changed
Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[ - "zone_not_found" -]New value: +[ + "zone_not_found", + "zone_forecast_unavailable", + "marine_forecast_unsupported" +]
6 tool updates
- Changed
nws_find_stations1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler."
- Changed
nws_get_forecast1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler."
- Changed
nws_get_observations1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `missing_input`: Neither station_id nor a (latitude, longitude) pair was provided `blank_station_id`: station_id was provided with a blank value `station_not_found`: Station ID does not exist in the NWS network `no_observations`: Station has no recent observations available `no_stations_nearby`: No observation stations exist near the requested coordinates `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `missing_input`: Neither station_id nor a (latitude, longitude) pair was provided. `blank_station_id`: station_id was provided with a blank value. `station_not_found`: Station ID does not exist in the NWS network. `no_observations`: Station has no recent observations available. `no_stations_nearby`: No observation stations exist near the requested coordinates. `out_of_scope`: Coordinates fall outside US National Weather Service coverage. Other values are possible when a failure originates below the handler."
- Changed
nws_get_office_discussion1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or a valid office has no current product of the requested type (episodic types like SPS and HWO are commonly empty) Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_products`: Office code is unknown, or a valid office has no current product of the requested type (episodic types like SPS and HWO are commonly empty). Other values are possible when a failure originates below the handler."
- Changed
nws_get_zone_forecast1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"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."New value: +"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."
- Changed
nws_search_alerts1 field changed- changed
Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided `invalid_area_code`: Area code is not a recognized US state, territory, or marine area `invalid_point`: Point coordinates are malformed or outside valid bounds `invalid_zone`: Zone code does not match the NWS zone-code shape `blank_location_filter`: An area, point, or zone filter was provided with a blank value `empty_filter_array`: An event, severity, urgency, certainty, or region filter was provided with no usable entries Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided. `invalid_area_code`: Area code is not a recognized US state, territory, or marine area. `invalid_point`: Point coordinates are malformed or outside valid bounds. `invalid_zone`: Zone code does not match the NWS zone-code shape. `blank_location_filter`: An area, point, or zone filter was provided with a blank value. `empty_filter_array`: An event, severity, urgency, certainty, or region filter was provided with no usable entries. Other values are possible when a failure originates below the handler."
1 tool update
- Changed
nws_search_alerts1 field changed- changed
Input schema / properties / cursor / descriptionPrevious value: -"Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches /alerts/active, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment."New value: +"Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches the active-alert feed, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment."
4 tool updates
- Changed
nws_find_stations2 fields changed- removed
Output schema / properties / stations / items / properties / elevationM / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / stations / items / properties / elevationM / typeAdded value: +[ + "number", + "null" +]
- Changed
nws_get_forecast6 fields changed- removed
Output schema / properties / periods / items / properties / dewpointC / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / periods / items / properties / dewpointC / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / periods / items / properties / precipChancePct / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / periods / items / properties / precipChancePct / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / periods / items / properties / relativeHumidityPct / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / periods / items / properties / relativeHumidityPct / typeAdded value: +[ + "number", + "null" +]
- Changed
nws_get_observations24 fields changed- removed
Output schema / properties / barometricPressurePa / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / barometricPressurePa / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / cloudLayers / items / properties / baseM / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / cloudLayers / items / properties / baseM / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / dewpointC / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / dewpointC / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / heatIndexC / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / heatIndexC / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / relativeHumidityPct / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / relativeHumidityPct / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / temperatureC / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / temperatureC / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / timeZone / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / timeZone / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / visibilityM / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / visibilityM / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / windChillC / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / windChillC / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / windDirectionDeg / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / windDirectionDeg / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / windGustKmh / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / windGustKmh / typeAdded value: +[ + "number", + "null" +] - removed
Output schema / properties / windSpeedKmh / anyOfRemoved value: -[ - { - "type": "number" - }, - { - "type": "null" - } -] - added
Output schema / properties / windSpeedKmh / typeAdded value: +[ + "number", + "null" +]
- Changed
nws_search_alerts12 fields changed- removed
Output schema / properties / alerts / items / properties / description / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / description / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / alerts / items / properties / ends / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / ends / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / alerts / items / properties / expires / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / expires / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / alerts / items / properties / headline / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / headline / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / alerts / items / properties / instruction / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / instruction / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / alerts / items / properties / onset / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / alerts / items / properties / onset / typeAdded value: +[ + "string", + "null" +]
7 tool updates
- Changed
nws_find_stations6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "stations", + "totalCount", + "shown" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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: `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler.", + "examples": [ + "out_of_scope" + ], + "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" +} - removed
Output schema / requiredRemoved value: -[ - "stations", - "totalCount", - "shown" -]
- Changed
nws_get_forecast6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "location", + "generatedAt", + "periods", + "totalCount", + "shown", + "mode" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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: `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler.", + "examples": [ + "out_of_scope" + ], + "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" +} - removed
Output schema / requiredRemoved value: -[ - "location", - "generatedAt", - "periods", - "totalCount", - "shown", - "mode" -]
- Changed
nws_get_observations6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "stationId", + "stationName", + "timestamp", + "timeZone", + "textDescription", + "temperatureC", + "dewpointC", + "windSpeedKmh", + "windDirectionDeg", + "windGustKmh", + "barometricPressurePa", + "visibilityM", + "relativeHumidityPct", + "heatIndexC", + "windChillC", + "cloudLayers", + "station", + "observedAt" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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: `missing_input`: Neither station_id nor a (latitude, longitude) pair was provided `blank_station_id`: station_id was provided with a blank value `station_not_found`: Station ID does not exist in the NWS network `no_observations`: Station has no recent observations available `no_stations_nearby`: No observation stations exist near the requested coordinates `out_of_scope`: Coordinates fall outside US National Weather Service coverage Other values are possible when a failure originates below the handler.", + "examples": [ + "missing_input", + "blank_station_id", + "station_not_found", + "no_observations", + "no_stations_nearby", + "out_of_scope" + ], + "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" +} - removed
Output schema / requiredRemoved value: -[ - "stationId", - "stationName", - "timestamp", - "timeZone", - "textDescription", - "temperatureC", - "dewpointC", - "windSpeedKmh", - "windDirectionDeg", - "windGustKmh", - "barometricPressurePa", - "visibilityM", - "relativeHumidityPct", - "heatIndexC", - "windChillC", - "cloudLayers", - "station", - "observedAt" -]
- Changed
nws_get_office_discussion6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "issuanceTime", + "issuingOffice", + "productCode", + "productName", + "productText", + "wmoCollectiveId" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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: `no_products`: Office code is unknown, or a valid office has no current product of the requested type (episodic types like SPS and HWO are commonly empty) Other values are possible when a failure originates below the handler.", + "examples": [ + "no_products" + ], + "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" +} - removed
Output schema / requiredRemoved value: -[ - "issuanceTime", - "issuingOffice", - "productCode", - "productName", - "productText", - "wmoCollectiveId" -]
- Changed
nws_get_zone_forecast6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "zoneId", + "updated", + "periods", + "periodCount" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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" +} - removed
Output schema / requiredRemoved value: -[ - "zoneId", - "updated", - "periods", - "periodCount" -]
- Changed
nws_list_alert_types6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "count", + "eventTypes" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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.", + "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" +} - removed
Output schema / requiredRemoved value: -[ - "count", - "eventTypes" -]
- Changed
nws_search_alerts6 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Input schema / additionalPropertiesAdded value: +false - changed
Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - added
Output schema / anyOfAdded value: +[ + { + "not": { + "required": [ + "error" + ] + }, + "required": [ + "alerts", + "totalCount", + "shown", + "appliedFilters" + ] + }, + { + "required": [ + "error" + ] + } +] - added
Output schema / properties / errorAdded value: +{ + "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: `mutually_exclusive_filters`: More than one of area, point, zone, region_type, or region provided `invalid_area_code`: Area code is not a recognized US state, territory, or marine area `invalid_point`: Point coordinates are malformed or outside valid bounds `invalid_zone`: Zone code does not match the NWS zone-code shape `blank_location_filter`: An area, point, or zone filter was provided with a blank value `empty_filter_array`: An event, severity, urgency, certainty, or region filter was provided with no usable entries Other values are possible when a failure originates below the handler.", + "examples": [ + "mutually_exclusive_filters", + "invalid_area_code", + "invalid_point", + "invalid_zone", + "blank_location_filter", + "empty_filter_array" + ], + "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" +} - removed
Output schema / requiredRemoved value: -[ - "alerts", - "totalCount", - "shown", - "appliedFilters" -]
3 tool updates
- Changed
nws_find_stations5 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Max stations per page (1-50). totalFound still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest."New value: +"Max stations per page (1-50). totalCount still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest." - added
Output schema / properties / shownAdded value: +{ + "description": "Number of stations returned in this page", + "type": "number" +} - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Number of stations returned in this page"New value: +"Total observation stations available near this location before the page limit was applied — NOT the number returned in this page, which is shown. Same value on every page of one query; compare it against shown to tell whether stations were withheld." - removed
Output schema / properties / totalFoundRemoved value: -{ - "description": "Total observation stations available near this location before the page limit was applied. Same value on every page of one query.", - "type": "number" -} - changed
Output schema / requiredPrevious value: -[ - "stations", - "totalFound", - "totalCount" -]New value: +[ + "stations", + "totalCount", + "shown" +]
- Changed
nws_get_forecast5 fields changed- removed
Output schema / properties / periodCountRemoved value: -{ - "description": "Number of forecast periods in this page (at most 48).", - "type": "number" -} - added
Output schema / properties / shownAdded value: +{ + "description": "Number of forecast periods in this page (at most 48).", + "type": "number" +} - added
Output schema / properties / totalCountAdded value: +{ + "description": "Total forecast periods available upstream before the page window was applied — NOT the number in this page, which is shown. Compare it against shown to tell whether periods were withheld.", + "type": "number" +} - removed
Output schema / properties / totalPeriodCountRemoved value: -{ - "description": "Total forecast periods available upstream before the page window was applied.", - "type": "number" -} - changed
Output schema / requiredPrevious value: -[ - "location", - "generatedAt", - "periods", - "periodCount", - "totalPeriodCount", - "mode" -]New value: +[ + "location", + "generatedAt", + "periods", + "totalCount", + "shown", + "mode" +]
- Changed
nws_search_alerts5 fields changed- changed
Input schema / properties / limit / descriptionPrevious value: -"Maximum number of alerts to include in this page (1-25, default 25). totalCount still reports the full number of matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest."New value: +"Maximum number of alerts to include in this page (1-25, default 25). totalCount still reports the full number of distinct matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest." - added
Output schema / properties / shownAdded value: +{ + "description": "Number of alerts included in this response", + "type": "number" +} - removed
Output schema / properties / shownCountRemoved value: -{ - "description": "Number of alerts included in this response", - "type": "number" -} - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Total number of matching alerts in this fetch, before the page window is applied"New value: +"Total distinct alerts matching the filters in this fetch, before the page window is applied. NWS repeats some alerts verbatim within one response; the copies are collapsed on id, so this counts each alert once. Compare against shown to tell whether matches were withheld from this page." - changed
Output schema / requiredPrevious value: -[ - "alerts", - "totalCount", - "shownCount", - "appliedFilters" -]New value: +[ + "alerts", + "totalCount", + "shown", + "appliedFilters" +]
2 tool updates
- Changed
nws_get_zone_forecast1 field changed- changed
Input schema / properties / zone_id / descriptionPrevious value: -"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 in \"affectedZones\" by nws_search_alerts. Format: two-letter state + \"Z\" + three-digit number."New value: +"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."
- Changed
nws_search_alerts17 fields changed- added
Input schema / properties / regionAdded value: +{ + "description": "Restrict to NWS marine region groups: \"AL\" (Alaska waters), \"AT\" (Atlantic Ocean), \"GL\" (Great Lakes), \"GM\" (Gulf of Mexico), \"PA\" (Eastern Pacific and US West Coast), \"PI\" (Central and Western Pacific). Marine alerts only — a land alert never matches. Mutually exclusive with area, point, zone, and region_type.", + "items": { + "enum": [ + "AL", + "AT", + "GL", + "GM", + "PA", + "PI" + ], + "type": "string" + }, + "type": "array" +} - added
Input schema / properties / region_typeAdded value: +{ + "description": "Restrict to land-based or marine alerts. Mutually exclusive with area, point, zone, and region.", + "enum": [ + "Land", + "Marine" + ], + "type": "string" +} - changed
Output schema / properties / alerts / items / properties / affectedZones / descriptionPrevious value: -"Affected zone codes"New value: +"Affected zones, each with the zone type that decides where it can chain" - added
Output schema / properties / alerts / items / properties / affectedZones / items / additionalPropertiesAdded value: +false - added
Output schema / properties / alerts / items / properties / affectedZones / items / descriptionAdded value: +"Affected zone with its NWS zone type" - added
Output schema / properties / alerts / items / properties / affectedZones / items / propertiesAdded value: +{ + "code": { + "description": "Zone code, e.g. \"WAZ558\" (forecast) or \"WAC033\" (county)", + "type": "string" + }, + "type": { + "description": "NWS zone type: \"forecast\", \"county\", or \"fire\" (\"unknown\" when upstream reports a shape this server cannot type). Only \"forecast\" codes have a zone text forecast — pass those to nws_get_zone_forecast. All types are valid values for this tool's own zone filter.", + "type": "string" + } +} - added
Output schema / properties / alerts / items / properties / affectedZones / items / requiredAdded value: +[ + "code", + "type" +] - changed
Output schema / properties / alerts / items / properties / affectedZones / items / typePrevious value: -"string"New value: +"object" - added
Output schema / properties / alerts / items / properties / description / anyOfAdded value: +[ + { + "type": "string" + }, + { + "type": "null" + } +] - changed
Output schema / properties / alerts / items / properties / description / descriptionPrevious value: -"Full alert description"New value: +"Full alert description; null when NWS publishes the alert without one" - removed
Output schema / properties / alerts / items / properties / description / typeRemoved value: -"string" - added
Output schema / properties / alerts / items / properties / effectiveAdded value: +{ + "description": "Message effective time (ISO 8601) — when this version of the CAP message takes effect. A property of the message, not of the hazard: distinct from onset (when the hazard begins) and from expires (when a superseding message is due). Usually equals sent.", + "type": "string" +} - added
Output schema / properties / alerts / items / properties / messageTypeAdded value: +{ + "description": "CAP message type: \"Alert\" for an original issuance, \"Update\" for a revision of an earlier message, \"Cancel\" for a cancellation.", + "type": "string" +} - added
Output schema / properties / alerts / items / properties / referencesAdded value: +{ + "description": "Prior alert messages this one supersedes, newest first. Empty for an original issuance — never inferred when NWS reports none.", + "items": { + "additionalProperties": false, + "description": "One prior message this alert supersedes", + "properties": { + "identifier": { + "description": "CAP identifier of the superseded message", + "type": "string" + }, + "sent": { + "description": "When the superseded message was issued (ISO 8601)", + "type": "string" + } + }, + "required": [ + "identifier", + "sent" + ], + "type": "object" + }, + "type": "array" +} - added
Output schema / properties / alerts / items / properties / sentAdded value: +{ + "description": "Message issuance time (ISO 8601) — when the office transmitted this CAP message. Describes the message, not the hazard: use it to judge how stale the report is.", + "type": "string" +} - added
Output schema / properties / alerts / items / properties / statusAdded value: +{ + "description": "This alert's own CAP status as reported by NWS (\"Actual\", \"Exercise\", \"System\", \"Test\", \"Draft\"). Distinct from the status input filter, which selects which alerts are searched — with the default filter every returned alert reads \"Actual\".", + "type": "string" +} - changed
Output schema / properties / alerts / items / requiredPrevious value: -[ - "id", - "event", - "headline", - "description", - "instruction", - "severity", - "urgency", - "certainty", - "areaDesc", - "onset", - "ends", - "expires", - "senderName", - "affectedZones" -]New value: +[ + "id", + "event", + "headline", + "description", + "instruction", + "severity", + "urgency", + "certainty", + "areaDesc", + "sent", + "effective", + "onset", + "ends", + "expires", + "status", + "messageType", + "references", + "senderName", + "affectedZones" +]
3 tool updates
- Changed
nws_find_stations6 fields changed- added
Input schema / properties / cursorAdded value: +{ + "description": "Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches the station list, so pages are contiguous within one response; the registry changes rarely, but a later call can window an updated list.", + "type": "string" +} - changed
Input schema / properties / limit / descriptionPrevious value: -"Max stations to return (1-50)."New value: +"Max stations per page (1-50). totalFound still reports every station near the point, so pass the returned nextCursor as cursor to reach the rest." - added
Output schema / properties / nextCursorAdded value: +{ + "description": "Opaque token for the next page of stations — pass it back as `cursor`. Omitted when this is the last page.", + "type": "string" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when no stations were found near the requested coordinates."New value: +"Guidance when no stations were found near the requested coordinates, when stations remain beyond this page, or when the supplied cursor points past the end of the list." - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Number of stations returned (respects the limit parameter)"New value: +"Number of stations returned in this page" - changed
Output schema / properties / totalFound / descriptionPrevious value: -"Total observation stations available near this location before the limit was applied"New value: +"Total observation stations available near this location before the page limit was applied. Same value on every page of one query."
- Changed
nws_get_forecast6 fields changed- added
Input schema / properties / cursorAdded value: +{ + "description": "Opaque continuation token from a previous response's nextCursor, to retrieve the next 48 periods. Omit for the first page. Every call re-fetches the forecast, so consecutive periods are contiguous within one response; NWS reissues forecasts through the day, so a later call can window a regenerated period array.", + "type": "string" +} - changed
Input schema / properties / hourly / descriptionPrevious value: -"If true, returns hourly forecast (next 48 one-hour periods) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity."New value: +"If true, returns hourly forecast (48 one-hour periods per page, ~156 available) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity." - added
Output schema / properties / nextCursorAdded value: +{ + "description": "Opaque token for the next page of periods — pass it back as `cursor`. Omitted when this is the last page.", + "type": "string" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Set when upstream returned more periods than the cap — states how many periods were omitted."New value: +"Set when periods remain beyond this page, or when the supplied cursor points past the end of the period array." - changed
Output schema / properties / periodCount / descriptionPrevious value: -"Number of forecast periods returned (capped at 48)."New value: +"Number of forecast periods in this page (at most 48)." - changed
Output schema / properties / totalPeriodCount / descriptionPrevious value: -"Total forecast periods available upstream before the cap was applied."New value: +"Total forecast periods available upstream before the page window was applied."
- Changed
nws_search_alerts6 fields changed- added
Input schema / properties / cursorAdded value: +{ + "description": "Opaque continuation token from a previous response's nextCursor. Omit for the first page. The token carries its own page size, so limit applies to the first page only. Every call re-fetches /alerts/active, so alerts are contiguous within one response but not across calls — the active set changes continuously as alerts are issued and expire, so a continued page covers the collection as it stands at that moment.", + "type": "string" +} - changed
Input schema / properties / limit / descriptionPrevious value: -"Maximum number of alerts to include in the response (1-25, default 25). totalCount still reports the full number of matches, so a small limit returns a digest of broad or national searches without dropping the total."New value: +"Maximum number of alerts to include in this page (1-25, default 25). totalCount still reports the full number of matches, so a small limit returns a digest of broad or national searches without dropping the total; pass the returned nextCursor as cursor to reach the rest." - changed
Output schema / properties / alerts / descriptionPrevious value: -"Matching alerts (capped at the requested limit, max 25)"New value: +"Matching alerts for this page (at most the requested limit, max 25)" - added
Output schema / properties / nextCursorAdded value: +{ + "description": "Opaque token for the next page of matches — pass it back as `cursor`. Omitted when this is the last page.", + "type": "string" +} - changed
Output schema / properties / notice / descriptionPrevious value: -"Guidance when no alerts matched — echoes applied filters and suggests how to broaden the search."New value: +"Guidance when no alerts matched (echoes applied filters and suggests how to broaden), when matches remain beyond this page, or when the supplied cursor points past the end of the match set." - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Total number of matching alerts before the limit/cap is applied"New value: +"Total number of matching alerts in this fetch, before the page window is applied"
1 tool update
- Changed
nws_get_forecast5 fields changed- changed
Input schema / properties / hourly / descriptionPrevious value: -"If true, returns hourly forecast (~156 periods) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity."New value: +"If true, returns hourly forecast (next 48 one-hour periods) instead of 12-hour named periods (14 periods). Hourly includes dewpoint and relative humidity." - added
Output schema / properties / noticeAdded value: +{ + "description": "Set when upstream returned more periods than the cap — states how many periods were omitted.", + "type": "string" +} - changed
Output schema / properties / periodCount / descriptionPrevious value: -"Number of forecast periods returned"New value: +"Number of forecast periods returned (capped at 48)." - added
Output schema / properties / totalPeriodCountAdded value: +{ + "description": "Total forecast periods available upstream before the cap was applied.", + "type": "number" +} - changed
Output schema / requiredPrevious value: -[ - "location", - "generatedAt", - "periods", - "periodCount", - "mode" -]New value: +[ + "location", + "generatedAt", + "periods", + "periodCount", + "totalPeriodCount", + "mode" +]
2 tool updates
- Changed
nws_get_forecast2 fields changed- changed
Input schema / properties / latitude / descriptionPrevious value: -"Latitude in decimal degrees (e.g., 47.6062). Truncated to 4 decimal places."New value: +"Latitude in decimal degrees (e.g., 47.6062)." - changed
Input schema / properties / longitude / descriptionPrevious value: -"Longitude in decimal degrees (e.g., -122.3321). Truncated to 4 decimal places."New value: +"Longitude in decimal degrees (e.g., -122.3321)."
- Changed
nws_search_alerts3 fields changed- added
Input schema / properties / limitAdded value: +{ + "default": 25, + "description": "Maximum number of alerts to include in the response (1-25, default 25). totalCount still reports the full number of matches, so a small limit returns a digest of broad or national searches without dropping the total.", + "maximum": 25, + "minimum": 1, + "type": "integer" +} - changed
Output schema / properties / alerts / descriptionPrevious value: -"Matching alerts (capped at 25)"New value: +"Matching alerts (capped at the requested limit, max 25)" - changed
Output schema / properties / totalCount / descriptionPrevious value: -"Total number of matching alerts before the 25-alert cap"New value: +"Total number of matching alerts before the limit/cap is applied"
1 tool update
- Changed
nws_search_alerts2 fields changed- added
Output schema / properties / alerts / items / properties / endsAdded value: +{ + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Hazard end (ISO 8601) — when the hazard is expected to end; null when open-ended (\"until further notice\"). Distinct from expires, which is the message-refresh time." +} - changed
Output schema / properties / alerts / items / requiredPrevious value: -[ - "id", - "event", - "headline", - "description", - "instruction", - "severity", - "urgency", - "certainty", - "areaDesc", - "onset", - "expires", - "senderName", - "affectedZones" -]New value: +[ + "id", + "event", + "headline", + "description", + "instruction", + "severity", + "urgency", + "certainty", + "areaDesc", + "onset", + "ends", + "expires", + "senderName", + "affectedZones" +]
Related MCP Connectors
US NWS weather alerts and 5-day forecasts for AI agents. $0.01 per call.
Forecasts for any US point, with context: alerts, what changed overnight, why, and history.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.
Related MCP Servers
- FlicenseBqualityDmaintenanceProvides weather forecasts and active alerts from the US National Weather Service API for US locations.2-
- FlicenseNot gradedqualityDmaintenanceProvides weather forecasts, current conditions, and alerts for US locations using the National Weather Service API.1-
- AlicenseNot gradedqualityDmaintenanceProvides US weather alerts and forecasts via the National Weather Service API.68 npmGPL 3.0
- AlicenseNot gradedqualityDmaintenanceProvides weather alerts and forecasts for US locations using the National Weather Service API.68 npmGPL 3.0
Glama MCP Gateway
Add one secure layer between your agents and this server.