Skip to content
Developer

Model Context Protocol · hosted and open source

Give your AI the tides

Connect an MCP client to NOAA tide predictions, currents, observed water levels, coastal weather, station facts, and local sun and moon context through one Perigee endpoint. The hosted server is ready without a key, and the open-source package can run locally over stdio.

Install the serverOfficial registry recordREST API reference

Choose the connection that fits the client

Two hosted endpoints, one tool catalog

PUBLIC OR API KEY

Streamable HTTP

https://perigeetides.com/mcp

Start anonymously, or send a Perigee key as an Authorization bearer token when the client supports custom headers.

OAUTH CONNECTION

Account-linked MCP

https://perigeetides.com/pro/mcp

Use this endpoint when the client can open an OAuth sign-in and should apply your Perigee account limits without exposing a key.

Claude · Cursor · VS Code · standard JSON

Install in the client you already use

Pick a client for its exact command, connector URL, one-click deep link, or portable MCP JSON. Installation never asks for a NOAA credential.

  1. Run this in your terminal — that's the whole setup:
terminal
claude mcp add --transport http perigee https://perigeetides.com/mcp

26 tools plus reference resources

Ask for the right coastal product

Water

  • noaa_get_water_levels
  • noaa_get_water_level_summaries
  • noaa_get_tide_predictions
  • noaa_get_currents
  • noaa_get_current_predictions

Weather

  • noaa_get_meteorological_data
  • nws_get_wind_forecast
  • nws_get_marine_forecast

Stations

  • noaa_search_stations
  • noaa_find_nearest_stations
  • noaa_get_station_info
  • noaa_get_station_datums
  • noaa_get_harmonic_constituents
  • noaa_get_tide_prediction_offsets
  • noaa_get_station_sensors
  • noaa_get_current_station_bins
  • noaa_get_station_flood_levels

Derived products

  • noaa_get_sea_level_trends
  • noaa_get_extreme_water_levels
  • noaa_get_high_tide_flooding
  • noaa_get_top_ten_water_levels

Sky

  • astro_get_moon_phase
  • astro_get_sun_times
  • astro_get_sun_position

Reference

  • noaa_get_reference_guide
  • perigee_whoami

The server also exposes noaa://reference/… resources and prompt templates. For a deterministic HTTP contract, use the REST API reference.

Interpretation contract

Preserve what the data means

Prediction is not observation

Astronomical tide predictions do not include wind, pressure, river flow, waves, or storm surge. Use an observed-water-level tool when the question is about what the gauge measured.

Tide height is not current speed

High and low water describe vertical water level. Flood, ebb, maximum current, and slack require a current-station product and can occur at different times.

Datum, units, and time zone travel with the value

Keep the returned station ID, vertical datum, units, local time zone, source timestamp, and unavailable fields with every answer.

Registry identity and source trail

Verify the server before you connect it

official MCP registry name
io.github.RyanCardin15/noaa-tides-and-currents-mcp
local stdio package
@ryancardin/noaa-tides-currents-mcp-server
Claude Code (local stdio)
claude mcp add noaa -- npx -y @ryancardin/noaa-tides-currents-mcp-server
  • Official MCP Registry

    Canonical registry identity and hosted Streamable HTTP transport.

  • npm

    Published package for local stdio use and self-hosting.

  • PulseMCP

    Independent MCP directory record.

  • Glama

    Independent MCP directory record and source overview.

  • GitHub source

    Open-source implementation, releases, issues, and package metadata.

Common questions

MCP server FAQ

Is the Perigee MCP server free?

Yes. The public /mcp endpoint works anonymously within the published request limit. A free Perigee key or OAuth connection raises capacity and ties usage to your account.

Which MCP endpoint should I use?

Use /mcp for anonymous access or a client that can send an API key. Use /pro/mcp when the client supports OAuth and should open a Perigee sign-in flow.

Can I run the server locally?

Yes. The @ryancardin/noaa-tides-currents-mcp-server package exposes a stdio server for local clients and self-hosting.

Does Perigee replace NOAA?

No. Perigee is an independent interface. NOAA CO-OPS and the National Weather Service remain the upstream authorities for the named data products returned by the tools.