National Weather Service MCP server for AI agents

Let Claude, ChatGPT or your own agent read National Weather Service: 26 typed functions through one MCP server. No National Weather Service API key needed.

Functions
26
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just National Weather Service

An MCP server for National Weather Service alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/nws
Every site

One MCP server for National Weather Service and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 26
  • findRadarStationsList NWS radar sites (WSR-88D and TDWR) with id, name, location and whether each is up right now, nearest-first for a place or by id.

    Arguments

    NameTypeRequired
    placestring
    A place name, ZIP or "lat,lon".
    No
    idstring
    One radar site id like "KBOX".
    No
    stationTypestring
    "WSR-88D" or "TDWR", the site's own labels.
    No
    limitnumber
    1-500, default 5 (ignored with id).
    No

    Returns NwsRadarStation[]

    interface NwsRadarStation {
      id: string;
      name: string;
      stationType: string;
      lat: number | null;
      lon: number | null;
      elevationMeters: number | null;
      /** True when the radar reports on-line and operating; null when it reports nothing. */
      up: boolean | null;
      operability: string | null;
      mode: string | null;
      lastReceived: string | null;
      distanceKm?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/findRadarStations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.findRadarStations({ id: "KBOX" });
  • findStationsFind NWS observation stations.

    Arguments

    NameTypeRequired
    placestring
    Exactly ONE of place / state.
    No
    statestring
    A two-letter state code, e.g. "MA".
    No
    limitnumber
    At most this many stations (default 10, max 500).
    No

    Returns NwsStation[]

    interface NwsStation {
      stationId: string;
      name: string;
      lat: number | null;
      lon: number | null;
      elevationMeters: number | null;
      timeZone: string;
      /** Forecast zone id, e.g. "MAZ014", or null when unlisted. */
      forecastZone: string | null;
      /** County zone id, e.g. "MAC017", or null when unlisted. */
      county: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/findStations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.findStations({ state: "MA", limit: 3 });
  • findZonesList NWS forecast, county, fire or marine zones by state or for a place, with zone id, name and type.

    Arguments

    NameTypeRequired
    placestring
    Exactly ONE of place / area.
    No
    areastring
    A two-letter state or marine area code, e.g. "MA".
    No
    typestring
    The API's zone type, e.g. "forecast", "county", "fire", "coastal", "offshore".
    No
    limitnumber
    At most this many zones (default 50, max 500).
    No

    Returns NwsZone[]

    interface NwsZone {
      id: string;
      /** The site's own zone type label, e.g. "public"; read the values off a result, never guess one from prose. */
      type: string;
      name: string;
      state: string | null;
      /** Forecast office ids, e.g. ["BOX"]. */
      offices: string[];
      timeZone: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/findZones

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.findZones({ area: "MA", type: "forecast", limit: 3 });
  • getActiveAlertsThe weather warnings, watches and advisories in effect right now.

    Arguments

    NameTypeRequired
    placestringNo
    areastringNo
    zonestringNo
    eventstringNo
    severitystringNo

    Returns NwsAlert[]

    interface NwsAlert {
      id: string;
      areaDesc: string;
      event: string;
      headline: string;
      severity: string;
      urgency: string;
      certainty: string;
      /** CAP alert status, the site's own labels, e.g. "Actual"; read the values off a result, never guess one from prose. */
      status: string;
      onset: string | null;
      expires: string | null;
      description: string;
      instruction: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getActiveAlerts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getActiveAlerts({ area: "TX" });
  • getAlertOne alert in full by its id.

    Arguments

    NameTypeRequired
    idstring
    An alert id as getActiveAlerts returns it, e.g. "urn:oid:2.49.0.1.840.0.…".
    Yes

    Returns NwsAlertDetail

    interface NwsAlert {
      id: string;
      areaDesc: string;
      event: string;
      headline: string;
      severity: string;
      urgency: string;
      certainty: string;
      /** CAP alert status, the site's own labels, e.g. "Actual"; read the values off a result, never guess one from prose. */
      status: string;
      onset: string | null;
      expires: string | null;
      description: string;
      instruction: string | null;
    }
    
    interface NwsAlertDetail extends NwsAlert {
      sent: string;
      ends: string | null;
      /** CAP message type, the site's own labels, e.g. "Alert"; read the values off a result, never guess one from prose. */
      messageType: string;
      senderName: string;
      response: string;
      /** Zone ids, e.g. "TXC377". */
      affectedZones: string[];
      /** The earlier alerts this one updates or cancels. */
      references: Array<{ id: string; sent: string }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getAlert

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getAlert({ id: "<id>" });
  • getAlertCountsHow many alerts are active right now, nationally and broken down by state, marine region and zone.

    Arguments

    None.

    Returns NwsAlertCounts

    interface NwsAlertCounts {
      total: number;
      land: number;
      marine: number;
      /** Marine region code (e.g. "AL", "GM") → active alerts. */
      regions: Record<string, number>;
      /** State or marine area code (e.g. "FL") → active alerts. */
      areas: Record<string, number>;
      /** Zone id (e.g. "TXZ102") → active alerts. */
      zones: Record<string, number>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getAlertCounts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getAlertCounts({});
  • getCurrentConditionsThe weather right now at the nearest observing station.

    Arguments

    NameTypeRequired
    placestring
    A station id like "KBOS", a place name ("Boston, MA"), a ZIP, or "lat,lon".
    Yes

    Returns NwsObservation

    interface NwsObservation {
      stationId: string;
      stationName: string;
      timestamp: string;
      textDescription: string;
      /** The raw METAR, or null when the station reported none. */
      rawMessage: string | null;
      temperatureCelsius: number | null;
      dewpointCelsius: number | null;
      relativeHumidity: number | null;
      windDirectionDegrees: number | null;
      windSpeedKmh: number | null;
      windGustKmh: number | null;
      barometricPressurePa: number | null;
      visibilityMeters: number | null;
      windChillCelsius: number | null;
      heatIndexCelsius: number | null;
      /** METAR sky-cover codes, the site's own labels, e.g. "CLR"; read the values off a result, never guess one from prose. */
      cloudLayers: Array<{ amount: string; baseMeters: number | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getCurrentConditions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getCurrentConditions({ place: "KBOS" });
  • getForecastThe 7-day forecast a person reads on weather.gov.

    Arguments

    NameTypeRequired
    placestringYes

    Returns ForecastPeriod[]

    interface ForecastPeriod {
      name: string;
      temperature: number;
      temperatureUnit: string;
      probabilityOfPrecipitation: number | null;
      dewpointCelsius: number | null;
      relativeHumidity: number | null;
      windSpeed: string;
      windDirection: string;
      shortForecast: string;
      detailedForecast: string;
      startTime: string;
      endTime: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getForecast({ place: "Boston, MA" });
  • getForecastDiscussionThe Area Forecast Discussion.

    Arguments

    NameTypeRequired
    placestring
    A forecast office id like "BOX", or a place name / ZIP / "lat,lon" resolved to its office.
    Yes

    Returns NwsTextProduct

    interface NwsTextProduct {
      id: string;
      productCode: string;
      productName: string;
      issuingOffice: string;
      issuanceTime: string;
      productText: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getForecastDiscussion

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getForecastDiscussion({ place: "BOX" });
  • getGridpointDataThe raw numbers behind a forecast for one grid cell.

    Arguments

    NameTypeRequired
    placestring
    A place name, ZIP or "lat,lon".
    Yes
    layersstring[]
    Only these layers, e.g. ["snowfallAmount", "windGust"].
    No

    Returns NwsGridpointData

    interface NwsGridpointData {
      gridId: string;
      gridX: number;
      gridY: number;
      updateTime: string;
      elevationMeters: number | null;
    
      layers: Record<
        string,
        { unit: string; values: Array<{ validTime: string; value: number | null }> }
      >;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getGridpointData

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getGridpointData({ place: "Boston, MA", layers: ["temperature"] });
  • getHourlyForecastThe hour-by-hour forecast for the next week.

    Arguments

    NameTypeRequired
    placestringYes

    Returns ForecastPeriod[]

    interface ForecastPeriod {
      name: string;
      temperature: number;
      temperatureUnit: string;
      probabilityOfPrecipitation: number | null;
      dewpointCelsius: number | null;
      relativeHumidity: number | null;
      windSpeed: string;
      windDirection: string;
      shortForecast: string;
      detailedForecast: string;
      startTime: string;
      endTime: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getHourlyForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getHourlyForecast({ place: "Boston, MA" });
  • getMarineForecastThe coastal-waters marine forecast for one marine zone.

    Arguments

    NameTypeRequired
    zonestring
    A marine zone id like "ANZ230" (Boston Harbor).
    Yes

    Returns NwsMarineForecast

    interface NwsMarineForecast {
      zone: string;
      zoneName: string;
      issued: string;
      headlines: string[];
      periods: Array<{ name: string; text: string }>;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getMarineForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getMarineForecast({ zone: "ANZ230" });
  • getObservationHistoryPast observations at a station across a time window.

    Arguments

    NameTypeRequired
    placestring
    A station id like "KBOS", a place name, a ZIP or "lat,lon" (resolved to its nearest station).
    Yes
    startstringNo
    endstring
    ISO-8601 instant.
    No
    limitnumber
    At most this many observations, newest first (default 24, max 500).
    No

    Returns NwsObservation[]

    interface NwsObservation {
      stationId: string;
      stationName: string;
      timestamp: string;
      textDescription: string;
      /** The raw METAR, or null when the station reported none. */
      rawMessage: string | null;
      temperatureCelsius: number | null;
      dewpointCelsius: number | null;
      relativeHumidity: number | null;
      windDirectionDegrees: number | null;
      windSpeedKmh: number | null;
      windGustKmh: number | null;
      barometricPressurePa: number | null;
      visibilityMeters: number | null;
      windChillCelsius: number | null;
      heatIndexCelsius: number | null;
      /** METAR sky-cover codes, the site's own labels, e.g. "CLR"; read the values off a result, never guess one from prose. */
      cloudLayers: Array<{ amount: string; baseMeters: number | null }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getObservationHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getObservationHistory({ place: "KBOS", limit: 3 });
  • getOfficeOne NWS forecast office, its name, street address, phone, email, the counties and zones it covers, and its approved observation stations.

    Arguments

    NameTypeRequired
    placestring
    A forecast office id like "BOX", or a place name / ZIP / "lat,lon" resolved to its office.
    Yes

    Returns NwsOffice

    interface NwsOffice {
      id: string;
      name: string;
      streetAddress: string;
      locality: string;
      region: string;
      postalCode: string;
      telephone: string;
      email: string;
      website: string | null;
      /** NWS region code, e.g. "er". */
      nwsRegion: string;
      /** Parent regional headquarters id, e.g. "ERH". */
      parentOffice: string | null;
      /** County zone ids, e.g. "MAC017". */
      counties: string[];
      /** Forecast zone ids, e.g. "MAZ015". */
      forecastZones: string[];
      /** Fire-weather zone ids. */
      fireZones: string[];
      /** Station ids, e.g. "KBOS". */
      observationStations: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getOffice

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getOffice({ place: "BOX" });
  • getOfficeHeadlinesThe headlines a forecast office has posted.

    Arguments

    NameTypeRequired
    placestring
    A forecast office id like "OKX", or a place name / ZIP / "lat,lon" resolved to its office.
    Yes

    Returns NwsOfficeHeadline[]

    interface NwsOfficeHeadline {
      id: string;
      title: string;
      link: string | null;
      summary: string | null;
      important: boolean;
      issuanceTime: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getOfficeHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getOfficeHeadlines({ place: "OKX" });
  • getPointEverything NWS knows about one place: its forecast office, forecast grid cell, forecast/county/fire zones, nearest radar, time zone and nearest named…

    Arguments

    NameTypeRequired
    placestringYes

    Returns NwsPoint

    interface NwsPoint {
      gridId: string;
      gridX: number;
      gridY: number;
      forecastZone: string;
      fireWeatherZone: string;
      county: string;
      radarStation: string;
      timeZone: string;
      city: string;
      state: string;
      lat: number;
      lon: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getPoint

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getPoint({ place: "Boston, MA" });
  • getTextProductThe latest issuance of any NWS text product for an office.

    Arguments

    NameTypeRequired
    typestring
    A product type code like "HWO", "CLI" or "CWF".
    No
    officestring
    A forecast office id like "BOX".
    No
    idstring
    One specific issuance id, instead of type + office.
    No

    Returns NwsTextProduct

    interface NwsTextProduct {
      id: string;
      productCode: string;
      productName: string;
      issuingOffice: string;
      issuanceTime: string;
      productText: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getTextProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getTextProduct({ type: "AFD", office: "BOX" });
  • getWeatherRadioWhat NOAA Weather Radio is broadcasting for a place right now, as plain text, and one transmitter's frequency, site, SAME codes and counties by call…

    Arguments

    NameTypeRequired
    placestring
    A place name, ZIP or "lat,lon".
    No
    callSignstring
    A transmitter call sign like "KHB35".
    No

    Returns NwsWeatherRadio

    interface NwsRadioTransmitter {
      callSign: string;
      frequencyMhz: string;
      siteName: string;
      siteCity: string;
      siteState: string;
      sameCodes: string[];
      counties: string[];
    }
    
    interface NwsWeatherRadio {
      /** The spoken broadcast for the place, one paragraph per segment; empty without place. */
      broadcast: string[];
      /** The asked transmitter; null without callSign. */
      transmitter: NwsRadioTransmitter | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getWeatherRadio

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getWeatherRadio({ place: "42.36,-71.06", callSign: "KHB35" });
  • getWeatherStoriesThe forecast office's current "weather story" graphics.

    Arguments

    NameTypeRequired
    placestring
    A forecast office id like "BOX", or a place name / ZIP / "lat,lon" resolved to its office.
    Yes

    Returns NwsWeatherStory[]

    interface NwsWeatherStory {
      title: string;
      description: string;
      altText: string;
      startTime: string;
      endTime: string;
      updateTime: string;
      priority: boolean;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getWeatherStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getWeatherStories({ place: "BOX" });
  • getZoneForecastThe text forecast NWS writes for a whole forecast zone or fire-weather zone.

    Arguments

    NameTypeRequired
    placestring
    A zone id like "MAZ015", or a place name / ZIP / "lat,lon" resolved to its zone.
    Yes
    kind"forecast" | "fire"
    "forecast" (default) or "fire".
    No

    Returns NwsZoneForecast

    interface NwsZoneForecast {
      zone: string;
      updated: string;
      periods: Array<{ number: number; name: string; detailedForecast: string }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/getZoneForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.getZoneForecast({ place: "MAZ015" });
  • listAlertTypesEvery alert event name NWS issues (Tornado Warning, Winter Storm Watch, Heat Advisory, …).

    Arguments

    None.

    Returns string[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/listAlertTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.listAlertTypes({});
  • listSigmetsThe SIGMETs in force, aviation hazard warnings for turbulence, icing, convection and volcanic ash, with their areas and valid times.

    Arguments

    NameTypeRequired
    atsustring
    One issuing office, e.g. "KKCI" (Aviation Weather Center, CONUS) or "KZAK" (Oakland oceanic).
    No
    limitnumber
    1-500, default 50.
    No

    Returns NwsSigmet[]

    interface NwsSigmet {
      id: string;
      atsu: string;
      fir: string | null;
      sequence: string | null;
      /** WMO hazard code like "EMBD_TS" or "SEV_TURB"; null when NWS leaves it blank. */
      phenomenon: string | null;
      issueTime: string;
      start: string;
      end: string;
      area: Array<{ lat: number; lon: number }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/listSigmets

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.listSigmets({});
  • listTextProductsWhich text products an office issues and the recent issuances of one type, with ids and issue times.

    Arguments

    NameTypeRequired
    officestring
    A forecast office id like "BOX".
    Yes
    typestring
    A product type code like "AFD".
    No
    limitnumber
    Issuances to return when type is given, 1-500 (default 10).
    No

    Returns NwsTextProductListing

    interface NwsTextProductListing {
      office: string;
      /** Every type the office issues, filled only when no type was asked. */
      types: Array<{ productCode: string; productName: string }>;
      /** Recent issuances of the asked type, newest first, pass an id to getTextProduct. */
      issuances: Array<{
        id: string;
        productCode: string;
        productName: string;
        issuingOffice: string;
        issuanceTime: string;
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/listTextProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.listTextProducts({ office: "BOX", type: "AFD", limit: 3 });
  • lookupGlossaryWhat an NWS term means, "red flag warning", "dewpoint", "QPF", from NWS's own glossary.

    Arguments

    NameTypeRequired
    termstring
    A term or part of one: "red flag warning", "dewpoint", "QPF".
    Yes
    limitnumber
    1-500, default 10.
    No

    Returns NwsGlossaryEntry[]

    interface NwsGlossaryEntry {
      term: string;
      definition: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/lookupGlossary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.lookupGlossary({ term: "red flag warning" });
  • searchAlertsAlerts that were issued in a past window.

    Arguments

    NameTypeRequired
    placestring
    At most ONE of place / area / zone; none searches the whole country.
    No
    areastring
    A two-letter state or marine area code, e.g. "FL".
    No
    zonestring
    A forecast, county, fire or marine zone id, e.g. "TXZ102".
    No
    eventstring
    One event name from listAlertTypes, e.g. "Tornado Warning".
    No
    severitystring
    Extreme, Severe, Moderate, Minor or Unknown.
    No
    startstring
    ISO-8601 instant, alerts sent at or after it.
    No
    endstring
    ISO-8601 instant, alerts sent at or before it.
    No
    limitnumber
    At most this many alerts, newest first (default 25, max 500).
    No
    cursorstring
    The nextCursor a previous page returned.
    No

    Returns NwsAlertPage

    interface NwsAlert {
      id: string;
      areaDesc: string;
      event: string;
      headline: string;
      severity: string;
      urgency: string;
      certainty: string;
      /** CAP alert status, the site's own labels, e.g. "Actual"; read the values off a result, never guess one from prose. */
      status: string;
      onset: string | null;
      expires: string | null;
      description: string;
      instruction: string | null;
    }
    
    interface NwsAlertPage {
      alerts: NwsAlert[];
      /** Pass back as cursor for the next, older page; null on the last page. */
      nextCursor: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/searchAlerts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.searchAlerts({ limit: 3 });
  • searchLocationTurn what a person types into weather.gov's own search box.

    Arguments

    NameTypeRequired
    querystringYes

    Returns SearchLocationResult[]

    interface SearchLocationResult {
      name: string;
      state: string;
      lat: number;
      lon: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nws/searchLocation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nws.searchLocation({ query: "Boston, MA" });

Use it from code