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
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/coopsOne 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/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.
getCurrentPredictionsGet current predictions for a station.Arguments
Name Type Required stationIdstringA CURRENT station id, e.g. "ca0101".Yes beginDatestring"YYYY-MM-DD"; omit both dates for today.No endDatestringDefaults to beginDate.No interval"MAX_SLACK"Omit for the regular 6-minute series.No units"english" | "metric"Default "english" (knots).No binstringWhich sensor depth bin; default is the station's own default.No Returns
CoopsCurrentPredictionsinterface 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/getCurrentPredictionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getCurrentPredictions({ stationId: "ca0101", interval: "MAX_SLACK" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getCurrentPredictions({"stationId": "ca0101", "interval": "MAX_SLACK"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getCurrentPredictions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"ca0101","interval":"MAX_SLACK"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getCurrentPredictions({ stationId: "ca0101", interval: "MAX_SLACK" });getCurrentsGet current observations for a station.Arguments
Name Type Required stationIdstringA CURRENT station id, e.g. "ca0101".Yes beginDatestring"YYYY-MM-DD"; omit both dates for today.No endDatestringDefaults to beginDate.No units"english" | "metric"Default "english" (knots).No binstringWhich sensor depth bin; default is the station's own default.No Returns
CoopsCurrentsinterface 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/getCurrentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getCurrents({ stationId: "ca0101" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getCurrents({"stationId": "ca0101"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getCurrents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"ca0101"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getCurrents({ stationId: "ca0101" });getHighLowTidesGet high/low tide extremes for a station and date range.Arguments
Name Type Required stationIdstringYes beginDatestring"YYYY-MM-DD", required, no "today" default (see below).Yes endDatestringDefaults to beginDate.No datumCoopsTideDatumDefault "MLLW".No units"english" | "metric"Default "english" (feet).No Returns
CoopsHighLowTidestype 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/getHighLowTidesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getHighLowTides({ stationId: "9414290", beginDate: { $daysFromNow: -72 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getHighLowTides({"stationId": "9414290", "beginDate": {"$daysFromNow": -72}}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getHighLowTides \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"9414290","beginDate":{"$daysFromNow":-72}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getHighLowTides({ stationId: "9414290", beginDate: { $daysFromNow: -72 } });getHighTideFloodingHistoryGet a station's annual high-tide flood day counts (major/moderate/minor).Arguments
Name Type Required stationIdstringYes Returns
CoopsHighTideFloodingHistoryinterface 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/getHighTideFloodingHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getHighTideFloodingHistory("8665530");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getHighTideFloodingHistory("8665530"))curl -X POST https://api.bowmark.ai/v1/sites/coops/getHighTideFloodingHistory \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"stationId":"8665530"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getHighTideFloodingHistory("8665530");getMeteorologicalObservationsGet a station's weather sensor readings (wind, air temperature, air pressure, water temperature, etc).Arguments
Name Type Required stationIdstringYes productCoopsMetProductYes beginDatestring"YYYY-MM-DD"; omit both dates for the latest reading.No endDatestringDefaults to beginDate.No units"english" | "metric"Default "english"; ignored by humidity AND by air_pressure (always millibars).No Returns
CoopsMeteorologicalObservationstype 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/getMeteorologicalObservationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getMeteorologicalObservations({ stationId: "9414290", product: "wind" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getMeteorologicalObservations({"stationId": "9414290", "product": "wind"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getMeteorologicalObservations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"9414290","product":"wind"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getMeteorologicalObservations({ stationId: "9414290", product: "wind" });getMonthlyMeanWaterLevelGet a station's monthly mean water levels across every tidal datum.Arguments
Name Type Required stationIdstringYes beginDatestring"YYYY-MM-DD", required, no default.Yes endDatestringDefaults to beginDate.No units"english" | "metric"Default "english" (feet).No Returns
CoopsMonthlyMeanWaterLevelinterface 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/getMonthlyMeanWaterLevelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getMonthlyMeanWaterLevel({ stationId: "8443970", beginDate: "2025-01-01", endDate: "2025-01-31" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getMonthlyMeanWaterLevel({ "stationId": "8443970", "beginDate": "2025-01-01", "endDate": "2025-01-31" }))curl -X POST https://api.bowmark.ai/v1/sites/coops/getMonthlyMeanWaterLevel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"8443970","beginDate":"2025-01-01","endDate":"2025-01-31"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required stationIdstringYes Returns
CoopsSeaLevelTrendinterface 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/getSeaLevelTrendCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getSeaLevelTrend("8665530");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getSeaLevelTrend("8665530"))curl -X POST https://api.bowmark.ai/v1/sites/coops/getSeaLevelTrend \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"stationId":"8665530"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getSeaLevelTrend("8665530");getStationDatumsGet a station's tidal datums (MHHW, MLLW, etc) and the epoch they're referenced to.Arguments
Name Type Required stationIdstringYes Returns
CoopsStationDatumsinterface 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/getStationDatumsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getStationDatums("9414290");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getStationDatums("9414290"))curl -X POST https://api.bowmark.ai/v1/sites/coops/getStationDatums \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"stationId":"9414290"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getStationDatums("9414290");getStationHarmonicConstituentsGet a station's harmonic constituents used to derive its tide predictions.Arguments
Name Type Required stationIdstringYes Returns
CoopsStationHarmonicConstituentsinterface 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/getStationHarmonicConstituentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getStationHarmonicConstituents("9414290");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getStationHarmonicConstituents("9414290"))curl -X POST https://api.bowmark.ai/v1/sites/coops/getStationHarmonicConstituents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"stationId":"9414290"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getStationHarmonicConstituents("9414290");getStationMetadataGet a station's location, timezone and the product pages it publishes.Arguments
Name Type Required stationIdstringYes Returns
CoopsStationMetadatainterface 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/getStationMetadataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getStationMetadata("9414290");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getStationMetadata("9414290"))curl -X POST https://api.bowmark.ai/v1/sites/coops/getStationMetadata \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"stationId":"9414290"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getStationMetadata("9414290");getTidePredictionsGet tide predictions for a station for specified dates.Arguments
Name Type Required stationIdstringYes beginDatestring"YYYY-MM-DD"; omit both dates for today.No endDatestringDefaults to beginDate.No datumCoopsTideDatumDefault "MLLW".No interval"6" | "h" | "hilo"Default "h"; "hilo" = high/low tides only.No units"english" | "metric"Default "english" (feet).No Returns
CoopsTidePredictionstype 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/getTidePredictionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getTidePredictions({ stationId: "9414290", interval: "hilo" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getTidePredictions({"stationId": "9414290", "interval": "hilo"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getTidePredictions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"9414290","interval":"hilo"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getTidePredictions({ stationId: "9414290", interval: "hilo" });getWaterLevelGet water level observations for a station.Arguments
Name Type Required stationIdstringYes beginDatestring"YYYY-MM-DD"; omit both dates for today.No endDatestringDefaults to beginDate.No datumCoopsTideDatumDefault "MLLW".No units"english" | "metric"Default "english" (feet).No Returns
CoopsWaterLeveltype 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/getWaterLevelCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.getWaterLevel({ stationId: "9414290" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.getWaterLevel({"stationId": "9414290"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/getWaterLevel \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"stationId":"9414290"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.getWaterLevel({ stationId: "9414290" });listStationsFind tide/current stations, optionally filtered by product type or state.Arguments
Name Type Required 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/listStationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.coops.listStations({ productType: "waterlevels" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.coops.listStations({"productType": "waterlevels"}))curl -X POST https://api.bowmark.ai/v1/sites/coops/listStations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"productType":"waterlevels"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.coops.listStations({ productType: "waterlevels" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/coops/<function> - OpenAPI
/v1/sites/coops/openapi.json