Nws Weather Mcp Server

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "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": {
      "type": "boolean",
      "default": false,
      "description": "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": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude in decimal degrees (e.g., 47.6062)."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude in decimal degrees (e.g., -122.3321)."
    },
    "include_amounts": {
      "type": "boolean",
      "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."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "station_id"
  ],
  "properties": {
    "end": {
      "type": "string",
      "pattern": "^\\s*(?:\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})\\s*)?$",
      "description": "Time to stop before (exclusive), in the same format as start. Omit to start from the most recent observation."
    },
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 10000,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "pattern": "^\\s*(?:\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})\\s*)?$",
      "description": "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": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "pattern": "^\\s*[A-Za-z0-9]+\\s*$",
      "minLength": 1,
      "description": "Observation station ID (e.g., \"KSEA\"), case-insensitive. Use nws_find_stations to discover station IDs near a coordinate."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "office"
  ],
  "properties": {
    "office": {
      "type": "string",
      "pattern": "^\\s*[A-Za-z0-9]{2,3}\\s*$",
      "minLength": 1,
      "description": "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": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 100,
      "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/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": {
      "enum": [
        "AFD",
        "HWO",
        "ZFP",
        "SPS",
        "FWF"
      ],
      "type": "string",
      "default": "AFD",
      "description": "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."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "area": {
      "type": "string",
      "pattern": "^\\s*(?:[A-Za-z]{2}\\s*)?$",
      "description": "US state/territory code (e.g., \"WA\", \"OK\", \"PR\") or marine area code (e.g., \"GM\"). Mutually exclusive with point and zone."
    },
    "zone": {
      "type": "string",
      "pattern": "^\\s*(?:[A-Za-z]{2}[CcZz]\\d{3}\\s*)?$",
      "description": "NWS forecast zone (e.g., \"WAZ558\") or county zone (e.g., \"WAC033\"). Mutually exclusive with area and point."
    },
    "event": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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": {
      "type": "integer",
      "default": 25,
      "maximum": 10000,
      "minimum": 1,
      "description": "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": {
      "type": "string",
      "pattern": "^\\s*(?:(?:-\\s*)?\\d(?:\\s*\\d)*(?:\\s*\\.\\s*\\d(?:\\s*\\d)*)?\\s*,\\s*(?:-\\s*)?\\d(?:\\s*\\d)*(?:\\s*\\.\\s*\\d(?:\\s*\\d)*)?\\s*)?$",
      "description": "Coordinates as \"lat,lon\" (e.g., \"47.6,-122.3\"). Returns alerts whose geometry contains this point. Mutually exclusive with area and zone."
    },
    "cursor": {
      "type": "string",
      "description": "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": {
      "type": "array",
      "items": {
        "enum": [
          "AL",
          "AT",
          "GL",
          "GM",
          "PA",
          "PI"
        ],
        "type": "string"
      },
      "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."
    },
    "status": {
      "enum": [
        "Actual",
        "Exercise",
        "System",
        "Test",
        "Draft"
      ],
      "type": "string",
      "default": "Actual",
      "description": "Alert status filter. Default \"Actual\". Use a different value only when you specifically need non-live alerts."
    },
    "urgency": {
      "type": "array",
      "items": {
        "enum": [
          "Immediate",
          "Expected",
          "Future",
          "Past"
        ],
        "type": "string"
      },
      "description": "Filter by urgency level."
    },
    "severity": {
      "type": "array",
      "items": {
        "enum": [
          "Extreme",
          "Severe",
          "Moderate",
          "Minor",
          "Unknown"
        ],
        "type": "string"
      },
      "description": "Filter by severity level."
    },
    "certainty": {
      "type": "array",
      "items": {
        "enum": [
          "Observed",
          "Likely",
          "Possible",
          "Unlikely",
          "Unknown"
        ],
        "type": "string"
      },
      "description": "Filter by certainty level."
    },
    "region_type": {
      "enum": [
        "Land",
        "Marine"
      ],
      "type": "string",
      "description": "Restrict to land-based or marine alerts. Mutually exclusive with area, point, zone, and region."
    }
  },
  "additionalProperties": false
}