National Hurricane Center MCP server for AI agents

Let Claude, ChatGPT or your own agent read National Hurricane Center: 21 typed functions through one MCP server. No National Hurricane Center API key needed.

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

Connect

Just National Hurricane Center

An MCP server for National Hurricane Center 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/nhc
Every site

One MCP server for National Hurricane Center 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 21
  • getBestTrackGet a FILED storm's best track from HURDAT2: its position, max winds, pressure and status every six hours (synoptic, plus NHC's own special points)…

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcBestTrackPoint[]

    interface nhcWindRadii {
      neNm: number | null;
      seNm: number | null;
      swNm: number | null;
      nwNm: number | null;
    }
    
    interface nhcBestTrackPoint {
      date: string; // "YYYYMMDD" UTC
      time: string; // "HHMM" UTC
      recordIdentifier: string; // "", "L" landfall, "I" intensity peak, …
      status: string; // "TD" | "TS" | "HU" | "EX" | "SD" | "SS" | "LO" | "WV" | "DB"
      lat: number;
      lon: number;
      maxWindKt: number;
      minPressureMb: number | null;
      windRadii34Nm: nhcWindRadii;
      windRadii50Nm: nhcWindRadii;
      windRadii64Nm: nhcWindRadii;
      maxWindRadiusNm: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getBestTrack

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getBestTrack({ stormId: "al142024" });
  • getForecastConeGet a storm's forecast track points and cone of uncertainty as coordinates, for mapping.

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcForecastCone

    interface nhcForecastPoint {
      label: string;
      validAt: string;
      lat: number;
      lon: number;
      maxWindKt: number | null;
      gustKt: number | null;
    }
    
    interface nhcForecastCone {
      stormId: string;
      advisoryNumber: number | null;
      cone: Array<{ lat: number; lon: number }>;
      trackLine: Array<{ lat: number; lon: number }>;
      points: nhcForecastPoint[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getForecastCone

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getForecastCone({});
  • getForecastDiscussionGet the forecaster's discussion for a storm.

    Arguments

    NameTypeRequired
    args{ discussionUrl: string }Yes

    Returns nhcForecastDiscussion

    interface nhcForecastDiscussion {
      number: number;
      text: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getForecastDiscussion({});
  • getMarineForecastGet NHC's offshore waters or high seas marine forecast for a zone: winds, seas and hazards by period.

    Arguments

    NameTypeRequired
    args{ product: 'OFFNT3' | 'OFFNT4' | 'OFFNT5' | 'OFFPZ7' | 'OFFPZ8' | 'HSFAT2' | 'HSFEP2'; zone?: string }Yes

    Returns nhcMarineForecast

    interface nhcMarineZoneForecast {
      zone: string;
      area: string;
      issued: string;
      periods: Array<{ period: string; text: string }>;
      text: string;
    }
    
    interface nhcMarineForecast {
      product: string;
      title: string;
      issued: string | null;
      zones: nhcMarineZoneForecast[];
      text: string;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getMarineForecast({ product: "OFFNT3" });
  • getReconObservationsGet the latest Hurricane Hunter aircraft reconnaissance reports for the Atlantic (AL) or East Pacific (EP) basin: vortex data messages, flight-level…

    Arguments

    NameTypeRequired
    args{ basin: 'AL' | 'EP' }Yes

    Returns nhcReconObservation[]

    interface nhcReconObservation {
      basin: 'AL' | 'EP';
      product: string;
      title: string;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getReconObservations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getReconObservations({ basin: "AL" });
  • getSatelliteImageryGet the latest GOES satellite image links for a basin.

    Arguments

    NameTypeRequired
    args{ basin?: 'AL' | 'EP' | 'CP' }No

    Returns nhcSatelliteImage[]

    interface nhcSatelliteImage {
      region: 'Atlantic' | 'Pacific';
      sector: string;
      product: string;
      imageUrl: string;
      loopUrl: string;
      animatedGifUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getSatelliteImagery

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getSatelliteImagery({ basin: "AL" });
  • getStormAdvisoryGet a storm's public advisory text.

    Arguments

    NameTypeRequired
    args{ advisoryUrl: string }Yes

    Returns nhcAdvisory

    interface nhcAdvisory {
      number: number;
      headline: string;
      location: string;
      maxWinds: string;
      pressure: string;
      movement: string;
      watchesWarnings: string;
      hazards: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getStormAdvisory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getStormAdvisory({});
  • getStormForecastGet a storm's forecast positions and intensities out to five days, with wind radii, from its forecast advisory.

    Arguments

    NameTypeRequired
    args{ forecastUrl: string }Yes

    Returns nhcForecastAdvisory

    interface nhcForecastAdvisory {
      number: number;
      headline: string;
      maxWinds: string;
      // day = days after the advisory time (12 h -> 0.5); category = NHC's qualifier ("POST-TROPICAL") or the Saffir-Simpson band ("TS", "CAT 3")
      forecastPoints: Array<{ day: number; lat: number; lon: number; category?: string; maxWindKt?: number }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getStormForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getStormForecast({});
  • getStormGraphicsList a storm's current forecast graphics.

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcStormGraphic[]

    interface nhcStormGraphic {
      title: string;
      imageUrl: string;
      thumbnailUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getStormGraphics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getStormGraphics({});
  • getStormInfoGet one storm's current status: position, intensity, pressure, movement, classification, and links to its latest advisory products.

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcStormInfo

    interface nhcCurrentStorm {
      id: string;
      bin: string;
      name: string;
      classification: string;
      intensity: number;
      pressure: number;
      position: { lat: number; lon: number };
      links?: {
        publicAdvisory?: string;
        forecastAdvisory?: string;
        forecastDiscussion?: string;
        windSpeedProbabilities?: string;
      };
    }
    
    interface nhcStormInfo extends nhcCurrentStorm {
      movement: { direction: string; speed: number };
      links: {
        publicAdvisory?: string;
        forecastAdvisory?: string;
        forecastDiscussion?: string;
        windSpeedProbabilities?: string;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getStormInfo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getStormInfo({});
  • getStormNamesGet the rotating list of tropical cyclone names for a basin and year, including which names have been used and which come next.

    Arguments

    NameTypeRequired
    args{ basin?: 'AL' | 'EP' | 'CP' }No

    Returns nhcStormNameList[]

    interface nhcStormNameList {
      basin: 'AL' | 'EP' | 'CP';
      list: string;
      names: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getStormNames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getStormNames({ basin: "AL" });
  • getTropicalCycloneReportGet the url of NHC's post-season Tropical Cyclone Report PDF for a FILED storm: the final meteorological history, casualties and damage.

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcTropicalCycloneReport

    interface nhcTropicalCycloneReport {
      stormId: string | null;
      name: string;
      year: number;
      basin: 'Atlantic' | 'Pacific';
      reportUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getTropicalCycloneReport

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getTropicalCycloneReport({ stormId: "al142024" });
  • getTropicalOutlookGet the Tropical Weather Outlook for a basin: each disturbance being watched, where it is, and its 2-day and 7-day formation chance.

    Arguments

    NameTypeRequired
    args{ basin: 'AL' | 'EP' | 'CP' }Yes

    Returns nhcTropicalOutlook

    interface nhcOutlookDisturbance {
      id: string;
      location: string;
      summary: string;
      riskLevel: string;
      formationChance2Day: string;
      formationChance7Day: string;
    }
    
    interface nhcTropicalOutlook {
      basin: string;
      issued: string;
      highestRisk2Day: string;
      highestRisk7Day: string;
      disturbances: nhcOutlookDisturbance[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getTropicalOutlook

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getTropicalOutlook({ basin: "AL" });
  • getTropicalWeatherDiscussionGet the Tropical Weather Discussion for the Atlantic or East Pacific: the analysts' synopsis of waves, troughs, convection and marine conditions.

    Arguments

    NameTypeRequired
    args{ basin: 'AL' | 'EP' }Yes

    Returns nhcTropicalWeatherDiscussion

    interface nhcTropicalWeatherDiscussion {
      basin: 'AL' | 'EP';
      issued: string;
      sections: Array<{ heading: string; text: string }>;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getTropicalWeatherDiscussion

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getTropicalWeatherDiscussion({ basin: "AL" });
  • getWatchesWarningsGet the watches and warnings in effect for a storm from its public advisory.

    Arguments

    NameTypeRequired
    args{ advisoryUrl: string }Yes

    Returns nhcWatchesWarnings

    interface nhcWatchesWarnings {
      watches: string[];
      warnings: string[];
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getWatchesWarnings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getWatchesWarnings({});
  • getWindSpeedProbabilitiesGet the probability of tropical-storm-force (34 kt), 50 kt and hurricane-force (64 kt) winds at each listed coastal and inland location for a storm.

    Arguments

    NameTypeRequired
    args{ productUrl: string }Yes

    Returns nhcWindSpeedProbabilities

    interface nhcWindProbability {
      location: string;
      thresholdKt: 34 | 50 | 64;
      periods: number[];
      cumulative: number;
    }
    
    interface nhcWindSpeedProbabilities {
      number: number;
      storm: string;
      locations: nhcWindProbability[];
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/getWindSpeedProbabilities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.getWindSpeedProbabilities({});
  • listCurrentStormsList every active tropical storm and hurricane across the Atlantic, East Pacific and Central Pacific, with id, name, classification, intensity…

    Arguments

    NameTypeRequired
    args{ basin?: 'AL' | 'EP' | 'CP' }No

    Returns nhcCurrentStorm[]

    interface nhcCurrentStorm {
      id: string;
      bin: string;
      name: string;
      classification: string;
      intensity: number;
      pressure: number;
      position: { lat: number; lon: number };
      links?: {
        publicAdvisory?: string;
        forecastAdvisory?: string;
        forecastDiscussion?: string;
        windSpeedProbabilities?: string;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/listCurrentStorms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.listCurrentStorms();
  • listMarineZonesList the offshore waters and high seas forecast areas NHC covers, with the zone code to pass to getMarineForecast.

    Arguments

    None.

    Returns nhcMarineZone[]

    interface nhcMarineZone {
      zone: string;
      area: string;
      product: string;
      productTitle: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/listMarineZones

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.listMarineZones();
  • listSeasonStormsList every storm of one hurricane season in a basin, with id, name and classification.

    Arguments

    NameTypeRequired
    args{ year: number, basin?: 'AL' | 'EP' | 'CP' }Yes

    Returns nhcSeasonStorm[]

    interface nhcSeasonStorm {
      id: string;
      name: string;
      classification: string;
      basin: 'AL' | 'EP' | 'CP';
      year: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/listSeasonStorms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.listSeasonStorms({ year: 2024, basin: "AL" });
  • listStormAdvisoriesList every forecast advisory, public advisory, discussion and wind probability product a storm has issued, with product type, sequence number, issue…

    Arguments

    NameTypeRequired
    args{ stormId: string }Yes

    Returns nhcAdvisoryProduct[]

    interface nhcAdvisoryProduct {
      product: 'fstadv' | 'public' | 'public_a' | 'discus' | 'wndprb' | 'update';
      number: number | null;
      issuedAt: string; // "YYYYMMDD HHMM" UTC; for a storm still active, when NHC posted it (minutes before the advisory time)
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/listStormAdvisories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.listStormAdvisories({});
  • searchStormsFind a storm by name. With no year, matches a currently active storm. With year, searches that season's archive (1998 onward) and returns every match.

    Arguments

    NameTypeRequired
    args{ name: string, year?: number, basin?: 'AL' | 'EP' | 'CP' }Yes

    Returns nhcSeasonStorm[]

    interface nhcSeasonStorm {
      id: string;
      name: string;
      classification: string;
      basin: 'AL' | 'EP' | 'CP';
      year: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/nhc/searchStorms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.nhc.searchStorms({ name: "MILTON", year: 2024 });

Use it from code