← clify home · catalogue

tidesandcurrents-noaa API for agents (unofficial) — JSON over curl | clify

NOAA Tides & Currents (CO-OPS): find tide, current and observation stations and fetch tide predictions, water levels, weather, current predictions, datums, harmonic constituents, sea level trends and storm surge alerts through NOAA's public metadata and data APIs.

Host: tidesandcurrents.noaa.gov. Call these verified read commands with plain curl; no install, key, or account. Use the public JSON API with plain curl. No install, key, account, or browser is needed. Example: curl 'https://clify-dev.netlify.app/sites.json'. Start with /search?q=weather, then call /abc/COMMAND. Responses are one JSON object. The hosted MCP and GitHub repo are also available.

Commands

search-tide-stations

Search tide prediction stations by name (e.g. 'Boston'); returns station IDs, state, region and coordinates Params: q*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/search-tide-stations?q=Boston'

list-stations

List all CO-OPS stations offering a given product type (water levels, met, currents, current predictions, datums, harmonic constituents, etc.) Params: type*, expand, units

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-stations?type=waterlevels&expand=products%2Csensors%2Cnotices'

get-station

Get metadata for one station by ID (name, location, timezone, flags) with optional expanded products, datums, details, notices, benchmarks Params: id*, expand, units

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-station?expand=datums%2Cdisclaimers%2Cnotices%2Cdetails%2Cbenchmarks'

get-station-datums

Get tidal datums for a station (MLLW, MHHW, MSL, NAVD88 etc.) plus LAT/HAT and record min/max Params: id*, units

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-station-datums'

get-station-sensors

List a station's sensors (water level, barometer, wind, temperature...) with status and elevation Params: id*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-station-sensors'

get-harmonic-constituents

Get tidal harmonic constituents (M2, S2, K1...) for a station: amplitude, phase, speed Params: id*, units

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-harmonic-constituents'

get-nearby-stations

List the stations nearest to a given station, with distance and station type Params: id*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-nearby-stations'

get-tide-prediction-offsets

Get tide prediction offsets for a station (reference vs. subordinate, time/height offsets to its reference station) Params: id*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-tide-prediction-offsets'

get-tide-predictions

Get tide predictions for a station: high/low times and heights or a regular time series, for a date or date range Params: station*, date, begin_date, end_date, range, interval, datum, units, time_zone

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-tide-predictions?station=9447130&date=today&begin_date=20261017&end_date=20261018'

get-observations

Get observed data for a station: water levels, air/water temperature, wind, air pressure, humidity, visibility, conductivity, salinity, air gap Params: station*, product*, date, begin_date, end_date, range, datum, interval, units, time_zone

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-observations?station=9447130&product=water_level&date=today&begin_date=20261017+12%3A00&end_date=20261018+23%3A59'

get-current-predictions

Get tidal current predictions for a current station: max flood/ebb and slack times and speeds, or a time series Params: station*, date, begin_date, end_date, range, interval, bin, vel_type, units, time_zone

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-current-predictions?station=cb0102&date=today'

list-tide-prediction-regions

Browse tide prediction geographic groups: top-level regions (lvl=4), states (lvl=5), or children of a parent group Params: lvl, parent, type

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-tide-prediction-regions?lvl=4&parent=1743'

list-tide-prediction-group-stations

List the sub-areas and tide prediction stations inside a geographic group (e.g. a state such as 1403 = Massachusetts) Params: id*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-tide-prediction-group-stations'

list-current-prediction-groups

Get the full hierarchy of current prediction regions and their stations (coast > state > area > station with bin) Params: none

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-current-prediction-groups'

list-ports-stations

List PORTS (Physical Oceanographic Real-Time System) stations with the sensors each provides Params: none

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-ports-stations'

get-data-inventory

Get a station's data inventory: which parameters it has measured and over what date ranges Params: stationId*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/get-data-inventory?stationId=9447130'

List relative sea level trends (inches/decade, period of record) for all US or global stations, or one station Params: affil, station

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-sea-level-trends?affil=US&station=8518750'

export-sea-level-trend-csv

Download a station's monthly mean sea level trend data as CSV (year, month, monthly MSL, linear trend, confidence bounds) Params: id*

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/export-sea-level-trend-csv'

list-storm-surge-events

List active storm surge / coastal inundation events (storm name, type, analysis, links) Params: none

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-storm-surge-events'

list-news

List recent NOAA Tides & Currents news posts Params: per_page, page

curl 'https://clify-dev.netlify.app/tidesandcurrents-noaa/list-news?per_page=4'