# noaa-tides-and-currents-mcp [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP  
**GitHub Stars:** 6  
**Views:** 8  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/noaa-tides-and-currents-mcp

## Description
NOAA tides and currents: water levels, tide predictions, currents, met data, flooding, sun and moon

## Tools
Capabilities this server exposes over MCP:

- **noaa_get_water_levels** — Observed water levels: 1-minute, 6-minute, or hourly series, preliminary/verified quality flags decoded
- **noaa_get_water_level_summaries** — high_low (HH/H/L/LL daily extremes), daily_mean (Great Lakes), daily_max_min, monthly_mean datum tables
- **noaa_get_tide_predictions** — Harmonic tide predictions — `hilo` high/low events (up to 10 years) or interval series
- **noaa_get_currents** — Observed current speed/direction by depth bin (ADCP), optional beam diagnostics
- **noaa_get_current_predictions** — Predicted currents — `max_slack` flood/ebb/slack events or interval series
- **noaa_get_meteorological_data** — Wind, air/water temperature, pressure, air gap (bridge clearance), conductivity, visibility, humidity, salinity
- **noaa_search_stations** — Search the station directory by capability type, name substring, state — paginated
- **noaa_find_nearest_stations** — Nearest stations to any lat/lon (great-circle, cached directory), filterable by type
- **noaa_get_station_info** — Full station record with expandable sensors, flood levels, benchmarks, bins, deployments...
- **noaa_get_station_datums** — Tidal datum elevations (MLLW, MSL, MHHW, NAVD88...), HAT/LAT, historic extremes, current or superseded epoch
- **noaa_get_harmonic_constituents** — The M2/S2/K1/... constituents behind a station's predictions (water level or current ellipse form)
- **noaa_get_prediction_offsets** — Subordinate-station time/height offsets from their reference stations (tide or current)
- **noaa_get_sea_level_trends** — Long-term relative sea level trend with error bars and observation period
- **noaa_get_sea_level_rise_projections** — 2022 Interagency SLR scenario projections per decade through 2150
- **noaa_get_extreme_water_levels** — Annual exceedance probability levels (e.g. the "100-year" water level)
- **noaa_get_top_ten_water_levels** — Highest water levels ever recorded, with causal events (hurricanes, nor'easters)
- **noaa_get_high_tide_flooding** — HTF flood-day counts (daily/monthly/seasonal/annual), outlooks, decadal projections, likelihoods
- **astro_get_moon_phase** — Phase, illumination, age, distance for a date or range (spring/neap tide context)
- **astro_get_next_moon_phase** — Next new/full/quarter moon date(s)
- **astro_get_sun_times** — Sunrise/sunset, twilights, golden hour, day length for any location/date
- **astro_get_sun_position** — Azimuth/altitude (+ approximate declination/RA)
- **astro_get_next_sun_event** — Next occurrence(s) of any sun event
- **nws_get_wind_forecast** — Hourly numeric wind forecast (speed/gust/direction, wave height where gridded) for any US lat/lon, up to ~7 days
- **nws_get_marine_forecast** — Official Coastal Waters Forecast narrative for the marine zone covering a lat/lon, incl. Small Craft Advisories
- **noaa_get_reference_guide** — Curated NOAA reference: products, datums, units, time zones, intervals, station types, data limits, quality flags, date formats, marine forecasts

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "noaa-tides-and-currents-mcp": {
    "command": "npx",
    "args": ["-y","noaa-tides-and-currents-mcp"]
  }
}
```

## Documentation

## What noaa-tides-and-currents-mcp MCP server does

The noaa-tides-and-currents-mcp MCP server gives an agent access to NOAA CO-OPS data and selected National Weather Service forecast products. It covers both current observations and derived information, including water levels, tide predictions, current speed and direction, meteorological measurements, station metadata, tidal datums, harmonic constituents, sea-level trends, flooding statistics, and projections.

The package also includes locally computed astronomy tools for moon phases, sunrise and sunset, twilight, golden hour, solar position, and upcoming sun events. NWS tools provide hourly wind forecasts for US coordinates and the official coastal waters forecast for the marine zone covering a location.

## How it works

The server accepts MCP tool calls and translates them into NOAA data requests or local calculations. Station tools can search by name, state, capability, or proximity, helping an agent identify the correct station before requesting observations or predictions. The station directory is cached for six hours, while request validation checks product-specific date ranges before contacting NOAA.

Most tools support a `response_format` choice of `markdown` or `json`. Markdown responses are formatted for reading and include units; JSON responses preserve structured payloads for downstream processing. Resources provide getting-started workflows and reference topics, while prompts support tide reports, boating-condition briefings, station flood-risk profiles, and station overviews.

Predictions should be interpreted as astronomical predictions rather than storm-surge forecasts. Observed water levels are useful for comparing actual conditions with those predictions.

## Setup and configuration

Run the noaa-tides-and-currents-mcp MCP server locally with Node.js and the published npm package:

```bash
npx -y @ryancardin/noaa-tides-currents-mcp-server
```

The default transport is stdio. An optional HTTP mode can expose a stateless streamable MCP endpoint on a chosen local port. Claude Desktop can launch the server with an MCP configuration using `npx`, the `-y` flag, and the package name. No API key is required because the referenced NOAA APIs are open.

## Tools and capabilities

The noaa-tides-and-currents-mcp MCP server includes tools for:

- Retrieving one-minute, six-minute, or hourly water-level observations, including decoded preliminary and verified quality flags.
- Requesting high and low tide events, interval tide predictions, current predictions, observed currents, and meteorological readings.
- Finding stations by capability, name, state, or geographic distance, then inspecting station records, sensors, datums, benchmarks, bins, deployments, and prediction offsets.
- Examining harmonic constituents, long-term relative sea-level trends, scenario projections through 2150, extreme water levels, historical top-ten levels, and high-tide flooding reports.
- Calculating moon and sun information and retrieving US wind and coastal marine forecasts.

The tools account for details such as different station ID formats, subordinate-station prediction offsets, Great Lakes daily-mean requirements, datum differences, and product-specific request limits. Current data can use depth bins and optional ADCP beam diagnostics. Tide predictions support high/low events for periods of up to ten years where the station and product allow it.

## Limitations and notes

Data availability depends on the selected NOAA station and product. Great Lakes stations use different datum conventions and do not provide tide predictions. Subordinate stations support only high/low predictions derived from reference-station offsets. Request spans vary by product, including shorter limits for high-frequency observations and longer limits for hourly or prediction data.

Units are not uniform across every measurement: for example, metric wind values use meters per second while metric current values use centimeters per second. Responses label units, but callers should still preserve the datum and time-zone context when comparing results. The server is intended for NOAA-supported US locations and forecasts; the supplied material does not document credentials, private data sources, or broader global forecast coverage.

_Full upstream README: https://allmcps.com/mcp/noaa-tides-and-currents-mcp/readme_