NOAA CO-OPS MCP server for AI agents

Let Claude, ChatGPT or your own agent read NOAA CO-OPS: 13 typed functions through one MCP server. No NOAA CO-OPS API key needed.

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

Connect

Just NOAA CO-OPS

An MCP server for NOAA CO-OPS 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/coops
Every site

One MCP server for NOAA CO-OPS 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 13
  • getCurrentPredictionsGet current predictions for a station.

    Arguments

    NameTypeRequired
    stationIdstring
    A CURRENT station id, e.g. "ca0101".
    Yes
    beginDatestring
    "YYYY-MM-DD"; omit both dates for today.
    No
    endDatestring
    Defaults to beginDate.
    No
    interval"MAX_SLACK"
    Omit for the regular 6-minute series.
    No
    units"english" | "metric"
    Default "english" (knots).
    No
    binstring
    Which sensor depth bin; default is the station's own default.
    No

    Returns CoopsCurrentPredictions

    interface CoopsCurrentPredictions {
      stationId: string;
      units: "english" | "metric";
      predictions: {
        time: string;
        velocityMajor: number;
        depth: string | null;
        meanFloodDir: number | null;
        meanEbbDir: number | null;
        bin: string | null;
        type?: "ebb" | "flood" | "slack"; // only with interval: "MAX_SLACK"
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getCurrentPredictions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getCurrentPredictions({ stationId: "ca0101", interval: "MAX_SLACK" });
  • getCurrentsGet current observations for a station.

    Arguments

    NameTypeRequired
    stationIdstring
    A CURRENT station id, e.g. "ca0101".
    Yes
    beginDatestring
    "YYYY-MM-DD"; omit both dates for today.
    No
    endDatestring
    Defaults to beginDate.
    No
    units"english" | "metric"
    Default "english" (knots).
    No
    binstring
    Which sensor depth bin; default is the station's own default.
    No

    Returns CoopsCurrents

    interface CoopsCurrents {
      stationId: string;
      units: "english" | "metric";
      readings: { time: string; speed: number; direction: number; bin: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getCurrents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getCurrents({ stationId: "ca0101" });
  • getHighLowTidesGet high/low tide extremes for a station and date range.

    Arguments

    NameTypeRequired
    stationIdstringYes
    beginDatestring
    "YYYY-MM-DD", required, no "today" default (see below).
    Yes
    endDatestring
    Defaults to beginDate.
    No
    datumCoopsTideDatum
    Default "MLLW".
    No
    units"english" | "metric"
    Default "english" (feet).
    No

    Returns CoopsHighLowTides

    type CoopsTideDatum = "MLLW" | "MLW" | "MSL" | "MTL" | "MHW" | "MHHW" | "NAVD" | "STND";
    
    interface CoopsHighLowTides {
      stationId: string;
      datum: CoopsTideDatum;
      units: "english" | "metric";
      extremes: { time: string; height: number; type: "H" | "L" | "HH" | "LL" }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getHighLowTides

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getHighLowTides({ stationId: "9414290", beginDate: { $daysFromNow: -72 } });
  • getHighTideFloodingHistoryGet a station's annual high-tide flood day counts (major/moderate/minor).

    Arguments

    NameTypeRequired
    stationIdstringYes

    Returns CoopsHighTideFloodingHistory

    interface CoopsHighTideFloodingHistory {
      stationId: string;
      years: {
        year: number;
        majorCount: number | null;
        moderateCount: number | null;
        minorCount: number | null;
        missingDays: number | null;
        percentComplete: number | null;
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getHighTideFloodingHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getHighTideFloodingHistory("8665530");
  • getMeteorologicalObservationsGet a station's weather sensor readings (wind, air temperature, air pressure, water temperature, etc).

    Arguments

    NameTypeRequired
    stationIdstringYes
    productCoopsMetProductYes
    beginDatestring
    "YYYY-MM-DD"; omit both dates for the latest reading.
    No
    endDatestring
    Defaults to beginDate.
    No
    units"english" | "metric"
    Default "english"; ignored by humidity AND by air_pressure (always millibars).
    No

    Returns CoopsMeteorologicalObservations

    type CoopsMetProduct = "wind" | "air_temperature" | "air_pressure" | "water_temperature" | "humidity";
    
    interface CoopsMeteorologicalObservations {
      stationId: string;
      product: CoopsMetProduct;
      units: "english" | "metric";
      readings: {
        time: string;
        value?: number; // every product except "wind"
        speed?: number; // "wind" only
        direction?: number; // "wind" only
        directionCompass?: string; // "wind" only
        gust?: number; // "wind" only
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getMeteorologicalObservations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getMeteorologicalObservations({ stationId: "9414290", product: "wind" });
  • getMonthlyMeanWaterLevelGet a station's monthly mean water levels across every tidal datum.

    Arguments

    NameTypeRequired
    stationIdstringYes
    beginDatestring
    "YYYY-MM-DD", required, no default.
    Yes
    endDatestring
    Defaults to beginDate.
    No
    units"english" | "metric"
    Default "english" (feet).
    No

    Returns CoopsMonthlyMeanWaterLevel

    interface CoopsMonthlyMeanWaterLevel {
      stationId: string;
      units: "english" | "metric";
      readings: {
        year: number;
        month: number;
        mhhw: number;
        mhw: number;
        msl: number;
        mtl: number;
        mlw: number;
        mllw: number;
        highest: number;
        lowest: number;
      }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getMonthlyMeanWaterLevel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getMonthlyMeanWaterLevel({
      stationId: "8443970",
      beginDate: "2025-01-01",
      endDate: "2025-01-31"
    });
  • getSeaLevelTrendGet a station's long-term sea-level trend.

    Arguments

    NameTypeRequired
    stationIdstringYes

    Returns CoopsSeaLevelTrend

    interface CoopsSeaLevelTrend {
      stationId: string;
      stationName: string;
      trendUnits: string; // e.g. "mm/yr" or "inches/decade", read it, don't assume
      trend: number;
      trendError: number;
      startDate: string | null; // "MM/DD/YYYY"
      endDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getSeaLevelTrend

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getSeaLevelTrend("8665530");
  • getStationDatumsGet a station's tidal datums (MHHW, MLLW, etc) and the epoch they're referenced to.

    Arguments

    NameTypeRequired
    stationIdstringYes

    Returns CoopsStationDatums

    interface CoopsStationDatum {
      name: string;
      description: string;
      value: number;
    }
    
    interface CoopsStationDatums {
      stationId: string;
      epoch: string | null;
      units: string | null;
      orthometricDatum: string | null;
      datums: CoopsStationDatum[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getStationDatums

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getStationDatums("9414290");
  • getStationHarmonicConstituentsGet a station's harmonic constituents used to derive its tide predictions.

    Arguments

    NameTypeRequired
    stationIdstringYes

    Returns CoopsStationHarmonicConstituents

    interface CoopsHarmonicConstituent {
      number: number;
      name: string;
      description: string;
      amplitude: number;
      phaseGmt: number;
      phaseLocal: number;
      speed: number;
    }
    
    interface CoopsStationHarmonicConstituents {
      stationId: string;
      units: string | null;
      constituents: CoopsHarmonicConstituent[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getStationHarmonicConstituents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getStationHarmonicConstituents("9414290");
  • getStationMetadataGet a station's location, timezone and the product pages it publishes.

    Arguments

    NameTypeRequired
    stationIdstringYes

    Returns CoopsStationMetadata

    interface CoopsStationProductPage {
      name: string;
      url: string;
    }
    
    interface CoopsStationMetadata {
      id: string;
      name: string;
      lat: number;
      lng: number;
      state: string | null;
      timezone: string | null;
      tidal: boolean;
      greatLakes: boolean;
      established: string | null;
      products: CoopsStationProductPage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getStationMetadata

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getStationMetadata("9414290");
  • getTidePredictionsGet tide predictions for a station for specified dates.

    Arguments

    NameTypeRequired
    stationIdstringYes
    beginDatestring
    "YYYY-MM-DD"; omit both dates for today.
    No
    endDatestring
    Defaults to beginDate.
    No
    datumCoopsTideDatum
    Default "MLLW".
    No
    interval"6" | "h" | "hilo"
    Default "h"; "hilo" = high/low tides only.
    No
    units"english" | "metric"
    Default "english" (feet).
    No

    Returns CoopsTidePredictions

    type CoopsTideDatum = "MLLW" | "MLW" | "MSL" | "MTL" | "MHW" | "MHHW" | "NAVD" | "STND";
    
    interface CoopsTidePredictions {
      stationId: string;
      datum: CoopsTideDatum;
      units: "english" | "metric";
      predictions: { time: string; height: number; type?: "high" | "low" }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getTidePredictions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getTidePredictions({ stationId: "9414290", interval: "hilo" });
  • getWaterLevelGet water level observations for a station.

    Arguments

    NameTypeRequired
    stationIdstringYes
    beginDatestring
    "YYYY-MM-DD"; omit both dates for today.
    No
    endDatestring
    Defaults to beginDate.
    No
    datumCoopsTideDatum
    Default "MLLW".
    No
    units"english" | "metric"
    Default "english" (feet).
    No

    Returns CoopsWaterLevel

    type CoopsTideDatum = "MLLW" | "MLW" | "MSL" | "MTL" | "MHW" | "MHHW" | "NAVD" | "STND";
    
    interface CoopsWaterLevel {
      stationId: string;
      datum: CoopsTideDatum;
      units: "english" | "metric";
      readings: { time: string; height: number; sigma: number | null; quality: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/getWaterLevel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.getWaterLevel({ stationId: "9414290" });
  • listStationsFind tide/current stations, optionally filtered by product type or state.

    Arguments

    NameTypeRequired
    productTypeCoopsStationProductTypeNo
    statestringNo

    Returns CoopsStation[]

    interface CoopsStation {
      id: string;
      name: string;
      lat: number;
      lng: number;
      state: string | null;
      timezone: string | null;
      tidal: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/coops/listStations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.coops.listStations({ productType: "waterlevels" });

Use it from code