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.
- Site
- api.weather.gov
- Functions
- 26
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
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/nwsOne 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/mcpSet it up in your clientBoth 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.
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
Name Type Required placestringA place name, ZIP or "lat,lon".No idstringOne radar site id like "KBOX".No stationTypestring"WSR-88D" or "TDWR", the site's own labels.No limitnumber1-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/findRadarStationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.findRadarStations({ id: "KBOX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.findRadarStations({"id": "KBOX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/findRadarStations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"KBOX"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.findRadarStations({ id: "KBOX" });findStationsFind NWS observation stations.Arguments
Name Type Required placestringExactly ONE of place / state.No statestringA two-letter state code, e.g. "MA".No limitnumberAt 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/findStationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.findStations({ state: "MA", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.findStations({"state": "MA", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/nws/findStations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"state":"MA","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringExactly ONE of place / area.No areastringA two-letter state or marine area code, e.g. "MA".No typestringThe API's zone type, e.g. "forecast", "county", "fire", "coastal", "offshore".No limitnumberAt 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/findZonesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.findZones({ area: "MA", type: "forecast", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.findZones({"area": "MA", "type": "forecast", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/nws/findZones \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"area":"MA","type":"forecast","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.findZones({ area: "MA", type: "forecast", limit: 3 });getActiveAlertsThe weather warnings, watches and advisories in effect right now.Arguments
Name Type Required 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/getActiveAlertsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getActiveAlerts({ area: "TX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getActiveAlerts({"area": "TX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getActiveAlerts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"area":"TX"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getActiveAlerts({ area: "TX" });getAlertOne alert in full by its id.Arguments
Name Type Required idstringAn alert id as getActiveAlerts returns it, e.g. "urn:oid:2.49.0.1.840.0.…".Yes Returns
NwsAlertDetailinterface 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/getAlertCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getAlert({ id: "<id>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getAlert({"id": "<id>"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getAlert \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"<id>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
NwsAlertCountsinterface 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/getAlertCountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getAlertCounts({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getAlertCounts({}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getAlertCounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getAlertCounts({});getCurrentConditionsThe weather right now at the nearest observing station.Arguments
Name Type Required placestringA station id like "KBOS", a place name ("Boston, MA"), a ZIP, or "lat,lon".Yes Returns
NwsObservationinterface 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/getCurrentConditionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getCurrentConditions({ place: "KBOS" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getCurrentConditions({"place": "KBOS"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getCurrentConditions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"KBOS"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getCurrentConditions({ place: "KBOS" });getForecastThe 7-day forecast a person reads on weather.gov.Arguments
Name Type Required 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/getForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getForecast({ place: "Boston, MA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getForecast({"place": "Boston, MA"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"Boston, MA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getForecast({ place: "Boston, MA" });getForecastDiscussionThe Area Forecast Discussion.Arguments
Name Type Required placestringA forecast office id like "BOX", or a place name / ZIP / "lat,lon" resolved to its office.Yes Returns
NwsTextProductinterface NwsTextProduct { id: string; productCode: string; productName: string; issuingOffice: string; issuanceTime: string; productText: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nws/getForecastDiscussionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getForecastDiscussion({ place: "BOX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getForecastDiscussion({"place": "BOX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getForecastDiscussion \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"BOX"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getForecastDiscussion({ place: "BOX" });getGridpointDataThe raw numbers behind a forecast for one grid cell.Arguments
Name Type Required placestringA place name, ZIP or "lat,lon".Yes layersstring[]Only these layers, e.g. ["snowfallAmount", "windGust"].No Returns
NwsGridpointDatainterface 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/getGridpointDataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getGridpointData({ place: "Boston, MA", layers: ["temperature"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getGridpointData({"place": "Boston, MA", "layers": ["temperature"]}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getGridpointData \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"Boston, MA","layers":["temperature"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getGridpointData({ place: "Boston, MA", layers: ["temperature"] });getHourlyForecastThe hour-by-hour forecast for the next week.Arguments
Name Type Required 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/getHourlyForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getHourlyForecast({ place: "Boston, MA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getHourlyForecast({"place": "Boston, MA"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getHourlyForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"Boston, MA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getHourlyForecast({ place: "Boston, MA" });getMarineForecastThe coastal-waters marine forecast for one marine zone.Arguments
Name Type Required zonestringA marine zone id like "ANZ230" (Boston Harbor).Yes Returns
NwsMarineForecastinterface 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/getMarineForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getMarineForecast({ zone: "ANZ230" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getMarineForecast({"zone": "ANZ230"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getMarineForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"zone":"ANZ230"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getMarineForecast({ zone: "ANZ230" });getObservationHistoryPast observations at a station across a time window.Arguments
Name Type Required placestringA station id like "KBOS", a place name, a ZIP or "lat,lon" (resolved to its nearest station).Yes startstringNo endstringISO-8601 instant.No limitnumberAt 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/getObservationHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getObservationHistory({ place: "KBOS", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getObservationHistory({"place": "KBOS", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getObservationHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"KBOS","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringA forecast office id like "BOX", or a place name / ZIP / "lat,lon" resolved to its office.Yes Returns
NwsOfficeinterface 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/getOfficeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getOffice({ place: "BOX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getOffice({"place": "BOX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getOffice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"BOX"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getOffice({ place: "BOX" });getOfficeHeadlinesThe headlines a forecast office has posted.Arguments
Name Type Required placestringA 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/getOfficeHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getOfficeHeadlines({ place: "OKX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getOfficeHeadlines({"place": "OKX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getOfficeHeadlines \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"OKX"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringYes Returns
NwsPointinterface 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/getPointCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getPoint({ place: "Boston, MA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getPoint({"place": "Boston, MA"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getPoint \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"Boston, MA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getPoint({ place: "Boston, MA" });getTextProductThe latest issuance of any NWS text product for an office.Arguments
Name Type Required typestringA product type code like "HWO", "CLI" or "CWF".No officestringA forecast office id like "BOX".No idstringOne specific issuance id, instead of type + office.No Returns
NwsTextProductinterface NwsTextProduct { id: string; productCode: string; productName: string; issuingOffice: string; issuanceTime: string; productText: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nws/getTextProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getTextProduct({ type: "AFD", office: "BOX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getTextProduct({"type": "AFD", "office": "BOX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getTextProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"type":"AFD","office":"BOX"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringA place name, ZIP or "lat,lon".No callSignstringA transmitter call sign like "KHB35".No Returns
NwsWeatherRadiointerface 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/getWeatherRadioCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getWeatherRadio({ place: "42.36,-71.06", callSign: "KHB35" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getWeatherRadio({"place": "42.36,-71.06", "callSign": "KHB35"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getWeatherRadio \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"42.36,-71.06","callSign":"KHB35"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getWeatherRadio({ place: "42.36,-71.06", callSign: "KHB35" });getWeatherStoriesThe forecast office's current "weather story" graphics.Arguments
Name Type Required placestringA 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/getWeatherStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getWeatherStories({ place: "BOX" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getWeatherStories({"place": "BOX"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getWeatherStories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"BOX"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.getWeatherStories({ place: "BOX" });getZoneForecastThe text forecast NWS writes for a whole forecast zone or fire-weather zone.Arguments
Name Type Required placestringA 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
NwsZoneForecastinterface NwsZoneForecast { zone: string; updated: string; periods: Array<{ number: number; name: string; detailedForecast: string }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nws/getZoneForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.getZoneForecast({ place: "MAZ015" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.getZoneForecast({"place": "MAZ015"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/getZoneForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"MAZ015"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listAlertTypesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.listAlertTypes({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.listAlertTypes({}))curl -X POST https://api.bowmark.ai/v1/sites/nws/listAlertTypes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required atsustringOne issuing office, e.g. "KKCI" (Aviation Weather Center, CONUS) or "KZAK" (Oakland oceanic).No limitnumber1-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/listSigmetsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.listSigmets({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.listSigmets({}))curl -X POST https://api.bowmark.ai/v1/sites/nws/listSigmets \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.listSigmets({});listTextProductsWhich text products an office issues and the recent issuances of one type, with ids and issue times.Arguments
Name Type Required officestringA forecast office id like "BOX".Yes typestringA product type code like "AFD".No limitnumberIssuances to return when type is given, 1-500 (default 10).No Returns
NwsTextProductListinginterface 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/listTextProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.listTextProducts({ office: "BOX", type: "AFD", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.listTextProducts({"office": "BOX", "type": "AFD", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/nws/listTextProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"office":"BOX","type":"AFD","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required termstringA term or part of one: "red flag warning", "dewpoint", "QPF".Yes limitnumber1-500, default 10.No Returns
NwsGlossaryEntry[]interface NwsGlossaryEntry { term: string; definition: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nws/lookupGlossaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.lookupGlossary({ term: "red flag warning" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.lookupGlossary({"term": "red flag warning"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/lookupGlossary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"term":"red flag warning"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.lookupGlossary({ term: "red flag warning" });searchAlertsAlerts that were issued in a past window.Arguments
Name Type Required placestringAt most ONE of place / area / zone; none searches the whole country.No areastringA two-letter state or marine area code, e.g. "FL".No zonestringA forecast, county, fire or marine zone id, e.g. "TXZ102".No eventstringOne event name from listAlertTypes, e.g. "Tornado Warning".No severitystringExtreme, Severe, Moderate, Minor or Unknown.No startstringISO-8601 instant, alerts sent at or after it.No endstringISO-8601 instant, alerts sent at or before it.No limitnumberAt most this many alerts, newest first (default 25, max 500).No cursorstringThe nextCursor a previous page returned.No Returns
NwsAlertPageinterface 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/searchAlertsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.searchAlerts({ limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.searchAlerts({"limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/nws/searchAlerts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.searchAlerts({ limit: 3 });searchLocationTurn what a person types into weather.gov's own search box.Arguments
Name Type Required querystringYes Returns
SearchLocationResult[]interface SearchLocationResult { name: string; state: string; lat: number; lon: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nws/searchLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nws.searchLocation({ query: "Boston, MA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nws.searchLocation({"query": "Boston, MA"}))curl -X POST https://api.bowmark.ai/v1/sites/nws/searchLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Boston, MA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nws.searchLocation({ query: "Boston, MA" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nws/<function> - OpenAPI
/v1/sites/nws/openapi.json