NOAA Tides and Currents

Official26 toolsLive

by RyanCardin15 · TypeScript

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

NOAA Tides & Currents MCP Server (io.github.RyanCardin15/noaa-tides-and-currents-mcp)

The NOAA Tides & Currents MCP server provides access to NOAA-related water data. It covers water levels, tide predictions, currents, meteorological data, flooding information, and sun and moon data. The repository is identified as io.github.RyanCardin15/noaa-tides-and-currents-mcp and includes 26 tools.

🛠️ Key Features

Water levels
Tide predictions
Currents
Meteorological (met) data
Flooding
Sun and moon data

🚀 Use Cases

Retrieve tide prediction information for planning
Check current conditions via currents and water levels
Use met data and flooding data for situational awareness
Incorporate sun/moon context into time-based workflows

⚡ Developer Benefits

MCP server with 26 available tools
Designed for model-context access to NOAA tides/currents datasets
Includes TypeScript-based project context (from repository excerpt)

⚠️ Limitations

Scope is limited to tides, currents, water levels, met data, flooding, and sun/moon information as described in the provided data

Captured live from the server via tools/list.

noaa_get_water_levels

Get observed water levels from a NOAA tide station as a time series. Choose the interval: "6" = standard 6-minute observations (preliminary or verified, max 31 days per request), "1" = 1-minute preliminary data (max 4 days), "hourly" = verified hourly heights (max 1 year). Heights are relative to the requested datum (MLLW by default — the US nautical chart zero). Returns per record: t (timestamp in requested time zone), v (height), s (sigma), f (quality flags, decoded in output), q (p=preliminary, v=verified). Recent data is preliminary; verification takes days to weeks. Use for: "what is the water level right now" (date=latest), storm surge analysis, comparing observed vs predicted tide. Do NOT use for future tides — use noaa_get_tide_predictions.

Parameters10

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
interval	string	optional	Observation interval: "6" = 6-minute (standard, 31-day max), "1" = 1-minute preliminary (4-day max), "hourly" = verified hourly heights (1-year max).
datum	string	optional	Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "interval": {
      "type": "string",
      "enum": [
        "1",
        "6",
        "hourly"
      ],
      "default": "6",
      "description": "Observation interval: \"6\" = 6-minute (standard, 31-day max), \"1\" = 1-minute preliminary (4-day max), \"hourly\" = verified hourly heights (1-year max)."
    },
    "datum": {
      "type": "string",
      "enum": [
        "MHHW",
        "MHW",
        "MTL",
        "MSL",
        "MLW",
        "MLLW",
        "NAVD",
        "STND",
        "IGLD",
        "LWD",
        "CRD"
      ],
      "description": "Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.",
      "default": "MLLW"
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_water_level_summaries

Get verified summary water-level products from a NOAA station: - high_low: each day's observed highs/lows with ty = HH (higher high), H, L, LL (lower low). Max 1 year per request. - daily_mean: daily mean levels — GREAT LAKES STATIONS ONLY; NOAA requires local standard time, which this tool applies automatically. Max 10 years. - daily_max_min: daily maxima/minima from hourly and 6-minute data with completeness percentages. Max 10 years. - monthly_mean: monthly tidal datum means (columns MHHW, MHW, MSL, MTL, MLW, MLLW, DTL, GT, MN, DHQ, DLQ, HWI, LWI, highest, lowest). Max 200 years — ideal for long-term climatology. Use for: historical extremes, mixed-tide analysis (HH vs H), long-term averages. For raw time series use noaa_get_water_levels; for future tides use noaa_get_tide_predictions.

Parameters10

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
product	string	required	Summary product: high_low (daily tide extremes, 1yr max), daily_mean (Great Lakes only, 10yr), daily_max_min (10yr), monthly_mean (datum means, 200yr).
datum	string	optional	Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "product": {
      "type": "string",
      "enum": [
        "high_low",
        "daily_mean",
        "daily_max_min",
        "monthly_mean"
      ],
      "description": "Summary product: high_low (daily tide extremes, 1yr max), daily_mean (Great Lakes only, 10yr), daily_max_min (10yr), monthly_mean (datum means, 200yr)."
    },
    "datum": {
      "type": "string",
      "enum": [
        "MHHW",
        "MHW",
        "MTL",
        "MSL",
        "MLW",
        "MLLW",
        "NAVD",
        "STND",
        "IGLD",
        "LWD",
        "CRD"
      ],
      "description": "Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.",
      "default": "MLLW"
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station",
    "product"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_tide_predictions

Get NOAA harmonic tide predictions (future or past) for a station. interval="hilo" (recommended for "when is high/low tide") returns the daily tide events with type H/L — up to 10 years per request. Other intervals (h, 1, 5, 6, 10, 15, 30, 60 minutes) return a height time series — up to 1 year per request. Heights are relative to the requested datum (MLLW default). Notes: - Great Lakes stations have NO tide predictions (lake levels are not tidal). - Subordinate stations (type "S") only support interval=hilo; use the station's reference (R) station for interval series. - Predictions are astronomical only — they exclude weather effects (storm surge, wind setup). Compare with noaa_get_water_levels for actual conditions.

Parameters10

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
interval	string	optional	"hilo" = high/low tide events only (max 10-year span). "h" = hourly, or 1/5/6/10/15/30/60-minute series (max 1-year span).
datum	string	optional	Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "interval": {
      "type": "string",
      "enum": [
        "hilo",
        "h",
        "1",
        "5",
        "6",
        "10",
        "15",
        "30",
        "60"
      ],
      "default": "hilo",
      "description": "\"hilo\" = high/low tide events only (max 10-year span). \"h\" = hourly, or 1/5/6/10/15/30/60-minute series (max 1-year span)."
    },
    "datum": {
      "type": "string",
      "enum": [
        "MHHW",
        "MHW",
        "MTL",
        "MSL",
        "MLW",
        "MLLW",
        "NAVD",
        "STND",
        "IGLD",
        "LWD",
        "CRD"
      ],
      "description": "Vertical reference datum for heights. MLLW is the standard chart datum for coastal stations. IGLD and LWD apply to Great Lakes stations ONLY; NAVD/CRD exist only at stations where computed. Check a station's supported datums with noaa_get_station_datums.",
      "default": "MLLW"
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_currents

Get observed current speed and direction from a NOAA current meter station. Current stations use alphanumeric IDs (e.g. "cb0102" Chesapeake, "bh0101" Boston Harbor) — NOT the 7-digit water-level station IDs. Find them with noaa_search_stations (type "currents") or noaa_find_nearest_stations. UNITS WARNING: english = knots, but metric = cm/s (centimeters/second, not m/s). Returns per record: t (time), s (speed), d (direction, degrees true), b (bin number). Max 7 days per request. Set expand_detailed=true to include per-beam echo intensity and correlation diagnostics.

Parameters10

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
bin	integer	optional	Depth bin number (current meters measure at multiple depths). Find valid bins with noaa_get_station_info (expand ["bins"]). bin=0 returns ALL bins but caps the request at 7 days. Omit at single-bin stations.
expand_detailed	boolean	optional	Include ADCP beam diagnostics (echo1-4, corr1-4) per record.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "bin": {
      "type": "integer",
      "minimum": 0,
      "description": "Depth bin number (current meters measure at multiple depths). Find valid bins with noaa_get_station_info (expand [\"bins\"]). bin=0 returns ALL bins but caps the request at 7 days. Omit at single-bin stations."
    },
    "expand_detailed": {
      "type": "boolean",
      "default": false,
      "description": "Include ADCP beam diagnostics (echo1-4, corr1-4) per record."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_current_predictions

Get predicted tidal currents for a NOAA current prediction station. interval="max_slack" (recommended for navigation) returns the tidal-current events — maximum flood, maximum ebb, and slack water times — up to 1 year per request. Other intervals (h, 1, 6, 10, 30, 60 minutes) return a velocity time series — up to 31 days. UNITS WARNING: english = knots; metric = cm/s. vel_type="speed_dir" returns Speed/Direction pairs; "default" returns velocities projected on the flood/ebb axis (Velocity_Major: positive = flood direction, negative = ebb) with meanFloodDir/meanEbbDir. Subordinate (type "S") prediction stations derive from a reference station — see noaa_get_prediction_offsets.

Parameters11

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
bin	integer	optional	Depth bin number (current meters measure at multiple depths). Find valid bins with noaa_get_station_info (expand ["bins"]). bin=0 returns ALL bins but caps the request at 7 days. Omit at single-bin stations.
interval	string	optional	"max_slack" = max flood/ebb + slack events (1-year max span); h/1/6/10/30/60 = time series (31-day max span).
vel_type	string	optional	"default" = flood/ebb-axis velocity (Velocity_Major signed: + flood, - ebb); "speed_dir" = speed and compass direction.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "bin": {
      "type": "integer",
      "minimum": 0,
      "description": "Depth bin number (current meters measure at multiple depths). Find valid bins with noaa_get_station_info (expand [\"bins\"]). bin=0 returns ALL bins but caps the request at 7 days. Omit at single-bin stations."
    },
    "interval": {
      "type": "string",
      "enum": [
        "max_slack",
        "h",
        "1",
        "6",
        "10",
        "30",
        "60"
      ],
      "default": "max_slack",
      "description": "\"max_slack\" = max flood/ebb + slack events (1-year max span); h/1/6/10/30/60 = time series (31-day max span)."
    },
    "vel_type": {
      "type": "string",
      "enum": [
        "default",
        "speed_dir"
      ],
      "default": "default",
      "description": "\"default\" = flood/ebb-axis velocity (Velocity_Major signed: + flood, - ebb); \"speed_dir\" = speed and compass direction."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_meteorological_data

Get observed meteorological/oceanographic sensor data from a NOAA station. Products: air_temperature, water_temperature, wind (speed/gust/direction), air_pressure, air_gap (bridge clearance to water surface), conductivity, visibility, humidity, salinity. Units by system: temps °F/°C; wind knots (english) or m/s (metric); air_gap feet/meters; visibility nautical miles/kilometers; air_pressure always millibars; salinity always PSU. Max span ~31 days per request; interval "6" (6-minute, default) or "h" (hourly). Not every station has every sensor — check with noaa_get_station_info (expand ["sensors"]). Water-level data is served by noaa_get_water_levels, not this tool.

Parameters10

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
product	string	required	Sensor product to retrieve.
interval	string	optional	"6" = 6-minute observations (default), "h" = hourly.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
time_zone	string	optional	Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst.
date	string	optional	Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.
begin_date	string	optional	Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].
end_date	string	optional	End date/time. Same formats as begin_date.
range	integer	optional	Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "product": {
      "type": "string",
      "enum": [
        "air_temperature",
        "water_temperature",
        "wind",
        "air_pressure",
        "air_gap",
        "conductivity",
        "visibility",
        "humidity",
        "salinity"
      ],
      "description": "Sensor product to retrieve."
    },
    "interval": {
      "type": "string",
      "enum": [
        "6",
        "h"
      ],
      "default": "6",
      "description": "\"6\" = 6-minute observations (default), \"h\" = hourly."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "time_zone": {
      "type": "string",
      "enum": [
        "gmt",
        "lst",
        "lst_ldt"
      ],
      "default": "lst_ldt",
      "description": "Time zone for timestamps: gmt = UTC, lst = station local standard time (no DST), lst_ldt = station local time with DST. Note: daily_mean data requires lst."
    },
    "date": {
      "type": "string",
      "enum": [
        "today",
        "latest",
        "recent"
      ],
      "description": "Shortcut window: \"today\" = midnight to now, \"latest\" = single most recent reading, \"recent\" = last 72 hours. Mutually exclusive with begin_date/end_date/range."
    },
    "begin_date": {
      "type": "string",
      "description": "Start date/time. Formats: yyyyMMdd, \"yyyyMMdd HH:mm\", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm]."
    },
    "end_date": {
      "type": "string",
      "description": "End date/time. Same formats as begin_date."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station",
    "product"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_search_stations

Search the NOAA CO-OPS station directory by capability type, name, and/or state. Filter with: - type: what the station does (waterlevels, tidepredictions, currents, currentpredictions, met, ...) — pick the type matching the data you plan to request. - name: case-insensitive substring ("San Francisco", "Boston"). - state: two-letter code ("CA", "MA"). Returns id, name, location, tide type, Great Lakes flag, and for prediction stations whether they are reference (R, harmonic) or subordinate (S, offset-based — hilo predictions only). Results are paginated (limit/offset). For proximity search by coordinates use noaa_find_nearest_stations instead.

Parameters6

type	string	optional	Station capability filter. Common: "waterlevels" (active water level), "tidepredictions", "currents" (observed currents), "currentpredictions", "met" (weather sensors). Full list via noaa_get_reference_guide topic "station_types".
name	string	optional	Case-insensitive substring of the station name.
state	string	optional	Two-letter US state/territory code, e.g. "CA".
limit	integer	optional	Maximum stations to return.
offset	integer	optional	Pagination offset.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "waterlevels",
        "historicwl",
        "met",
        "waterlevelsandmet",
        "tidepredictions",
        "harcon",
        "datums",
        "supersededdatums",
        "benchmarks",
        "supersededbenchmarks",
        "currents",
        "historiccurrents",
        "surveycurrents",
        "currentpredictions",
        "cond",
        "watertemp",
        "physocean",
        "tcoon",
        "1minute",
        "airgap",
        "visibility",
        "highwater",
        "lowwater"
      ],
      "description": "Station capability filter. Common: \"waterlevels\" (active water level), \"tidepredictions\", \"currents\" (observed currents), \"currentpredictions\", \"met\" (weather sensors). Full list via noaa_get_reference_guide topic \"station_types\"."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Case-insensitive substring of the station name."
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Two-letter US state/territory code, e.g. \"CA\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Maximum stations to return."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Pagination offset."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_find_nearest_stations

Find the NOAA stations closest to a latitude/longitude point, sorted by distance. Use this to answer "what's the tide station near <place>?" — geocode the place to coordinates first, then call this. Filter by type to match the data you need (e.g. type "tidepredictions" before calling noaa_get_tide_predictions, "currents" before noaa_get_currents — current stations have different IDs than water-level stations). Distance is computed great-circle (Haversine) and reported in both km and miles. (NOAA's API has no native coordinate search; this tool maintains a cached station directory.)

Parameters6

latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
type	string	optional	Station capability filter. Common: "waterlevels" (active water level), "tidepredictions", "currents" (observed currents), "currentpredictions", "met" (weather sensors). Full list via noaa_get_reference_guide topic "station_types".
limit	integer	optional	Number of stations to return.
max_distance_km	number	optional	Optional cutoff radius in kilometers.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "type": {
      "type": "string",
      "enum": [
        "waterlevels",
        "historicwl",
        "met",
        "waterlevelsandmet",
        "tidepredictions",
        "harcon",
        "datums",
        "supersededdatums",
        "benchmarks",
        "supersededbenchmarks",
        "currents",
        "historiccurrents",
        "surveycurrents",
        "currentpredictions",
        "cond",
        "watertemp",
        "physocean",
        "tcoon",
        "1minute",
        "airgap",
        "visibility",
        "highwater",
        "lowwater"
      ],
      "description": "Station capability filter. Common: \"waterlevels\" (active water level), \"tidepredictions\", \"currents\" (observed currents), \"currentpredictions\", \"met\" (weather sensors). Full list via noaa_get_reference_guide topic \"station_types\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Number of stations to return."
    },
    "max_distance_km": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Optional cutoff radius in kilometers."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_station_info

Get a NOAA station's full metadata record: location, state, time zone, tide type, Great Lakes flag, capability flags, and links to available sub-resources. Optionally expand sub-resources inline via the "expand" list: - details (established/removed dates), sensors (installed instruments + elevations), floodlevels (NOS/NWS minor/moderate/major flood thresholds), benchmarks, products (available data page links), notices, disclaimers — for water-level stations - bins (ADCP depth bins), deployments — for current stations (alphanumeric IDs) Use this before requesting data to confirm what the station actually collects. For datum values use noaa_get_station_datums; for harmonic constituents use noaa_get_harmonic_constituents.

Parameters4

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
expand	array	optional	Sub-resources to embed inline (availability varies by station type).
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "expand": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "details",
          "sensors",
          "floodlevels",
          "benchmarks",
          "products",
          "notices",
          "disclaimers",
          "bins",
          "deployments"
        ]
      },
      "description": "Sub-resources to embed inline (availability varies by station type)."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_station_datums

Get the accepted tidal datum values for a station: the elevations of MHHW, MHW, MTL, MSL, DTL, MLW, MLLW, STND, NAVD88 (where computed), plus GT (great diurnal range), MN (mean range), LAT/HAT (lowest/highest astronomical tide), and the station's historical extreme min/max water levels with dates. epoch "current" returns the present National Tidal Datum Epoch (1983–2001) values; "superseded" returns the prior epoch's values (useful for historical comparisons — not all stations have one). All values share one reference zero (the station datum), so datum-to-datum conversion is subtraction: height_above_MLLW = height_above_MSL + (MSL − MLLW). Use this tool to (1) check which datums a station supports before requesting data, and (2) convert heights between datums.

Parameters4

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
epoch	string	optional	"current" = present NTDE (1983–2001); "superseded" = prior epoch values.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "epoch": {
      "type": "string",
      "enum": [
        "current",
        "superseded"
      ],
      "default": "current",
      "description": "\"current\" = present NTDE (1983–2001); \"superseded\" = prior epoch values."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_harmonic_constituents

Get the harmonic constituents NOAA uses to compute tide or current predictions at a station — the amplitude, phase, and angular speed of each tidal constituent (M2, S2, N2, K1, O1, ...). For water-level stations: amplitude (feet/meters), phase_GMT and phase_local (degrees), speed (degrees/hour). For current stations (alphanumeric IDs) constituents are current ellipses (major/minor amplitudes and phases per depth bin — pass bin to filter). Use for: building custom tide computations, checking a station's dominant constituents (M2 amplitude indicates semidiurnal range), verifying whether a station is harmonically predicted at all. Only reference (R) stations have constituents — subordinate stations use offsets (noaa_get_prediction_offsets).

Parameters4

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
bin	integer	optional	For current stations: restrict to one depth bin.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "bin": {
      "type": "integer",
      "minimum": 1,
      "description": "For current stations: restrict to one depth bin."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_prediction_offsets

Get the offsets a subordinate (type "S") prediction station applies to its reference station's predictions. kind "tide": returns refStationId, time offsets for high/low tide (minutes), height offsets for high/low tide, and whether the height adjustment is a ratio (multiplied) or fixed value — this is how NOAA derives subordinate-station tide times from the reference harmonic station. kind "current": returns refStationId/bin, mean flood/ebb directions, and time adjustments (minutes) for max flood, slack-before-ebb, max ebb, slack-before-flood plus amplitude ratios. Note: current prediction offsets are indexed per bin — pass the station_bin_suffix ID form (e.g. "ACT0091_1") if the plain ID returns nothing. Reference (R) stations return empty/null offsets — they don't need any.

Parameters3

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
kind	string	optional	"tide" = tidepredoffsets; "current" = currentpredictionoffsets.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "kind": {
      "type": "string",
      "enum": [
        "tide",
        "current"
      ],
      "default": "tide",
      "description": "\"tide\" = tidepredoffsets; \"current\" = currentpredictionoffsets."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_sea_level_trends

Get the long-term relative sea level trend at a NOAA station: trend and error (reported by NOAA in mm/yr or inches/decade — the payload's trendUnits field says which), the observation period (startDate/endDate), and seasonal amplitude. Relative sea level combines ocean rise AND local land movement (subsidence/uplift), so trends vary widely by station (e.g. strongly positive on the Gulf Coast, negative in Alaska). Requires a station with a long water-level record; omit station to list all (affil "US" or "Global" filters the network).

Parameters3

station	string	optional	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
affil	string	optional	Network filter when listing multiple stations.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "affil": {
      "type": "string",
      "enum": [
        "US",
        "Global"
      ],
      "description": "Network filter when listing multiple stations."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_sea_level_rise_projections

Get NOAA's Interagency Sea Level Rise Scenario projections for a station (from the 2022 technical report): projected relative sea level (meters or feet, see units field) per decade through 2150 under the chosen scenario. Scenarios: low, intermediate-low, intermediate, intermediate-high, high, extreme, or all. Use for coastal planning questions ("how much sea level rise is projected at X by 2050?"). Pair with noaa_get_sea_level_trends (observed) and noaa_get_high_tide_flooding (flooding impact).

Parameters5

station	string	optional	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
scenario	string	optional	Emissions/rise scenario from the 2022 Interagency report.
projection_year	integer	optional	Filter to a single decade year (e.g. 2050).
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "scenario": {
      "type": "string",
      "enum": [
        "all",
        "low",
        "intermediate-low",
        "intermediate",
        "intermediate-high",
        "high",
        "extreme"
      ],
      "default": "intermediate",
      "description": "Emissions/rise scenario from the 2022 Interagency report."
    },
    "projection_year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2150,
      "description": "Filter to a single decade year (e.g. 2050)."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_extreme_water_levels

Get NOAA's extreme water level exceedance statistics for a station: the annual exceedance probability levels (e.g. the 1%-annual-chance "100-year" level) and historical extreme events, computed from the station's verified record. Use for flood risk questions ("what water level has a 1% chance per year at X?"). Levels are relative to the station's datums for the 1983–2001 epoch. Only long-record stations have this product.

Parameters5

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
extremeType	string	optional	Extreme statistics basis: annual (default) or monthly extremes.
levelType	string	optional	High extremes (default) or low.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "extremeType": {
      "type": "string",
      "enum": [
        "annuals",
        "monthlies"
      ],
      "description": "Extreme statistics basis: annual (default) or monthly extremes."
    },
    "levelType": {
      "type": "string",
      "enum": [
        "high",
        "low"
      ],
      "description": "High extremes (default) or low."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_top_ten_water_levels

Get a station's highest recorded water levels: analysis "toptenwaterlevels" returns the ten highest events on record (with date, height, causal event name like "Great New England Hurricane", and category); "peakwaterlevels" returns peak event records (optionally filtered by year). Heights are relative to the requested datum (MHHW is typical for flood comparisons). Use for "what's the worst flooding ever recorded at X?".

Parameters6

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
analysis	string	optional	"toptenwaterlevels" = ten highest on record; "peakwaterlevels" = peak event records.
datum	string	optional	Reference datum for reported heights (MHHW is standard for flood context).
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
year	integer	optional	For peakwaterlevels: filter to one year.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "analysis": {
      "type": "string",
      "enum": [
        "toptenwaterlevels",
        "peakwaterlevels"
      ],
      "default": "toptenwaterlevels",
      "description": "\"toptenwaterlevels\" = ten highest on record; \"peakwaterlevels\" = peak event records."
    },
    "datum": {
      "type": "string",
      "enum": [
        "STND",
        "MHHW",
        "MHW",
        "MSL",
        "MTL",
        "MLW",
        "MLLW",
        "NAVD",
        "IGLD",
        "LWD"
      ],
      "default": "MHHW",
      "description": "Reference datum for reported heights (MHHW is standard for flood context)."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "year": {
      "type": "integer",
      "description": "For peakwaterlevels: filter to one year."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_high_tide_flooding

Get NOAA high tide flooding (HTF, "nuisance"/"sunny day" flooding) statistics for a station. Reports: - daily: flood occurrence per day (REQUIRES start_date and end_date, YYYYMMDD) - monthly / seasonal / annual: counts of minor/moderate/major flood days per period (filter with year/month/season_months, or range = last N periods) - met_year_annual: counts by meteorological year (May–April) - annual_outlook: NOAA's projected flood-day outlook for the coming met year - projections: decadal flood-day projections through 2100 (filter by decade, flood_threshold) - record_days: record flood-day counts - likely_scenarios: likely decadal flooding scenarios - daily_likelihoods: day-by-day flood likelihood forecasts Use for: "how often does X flood?", trends in nuisance flooding, future flooding projections. Not all stations have HTF products — check the HTFhistorical flag via noaa_get_station_info.

Parameters12

station	string	required	Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. "9414290" San Francisco); current stations use alphanumeric IDs (e.g. "cb0102"). Find stations with noaa_search_stations or noaa_find_nearest_stations.
report	string	optional	Which HTF report to retrieve (see tool description).
start_date	string	optional	YYYYMMDD — required for report "daily".
end_date	string	optional	YYYYMMDD — required for report "daily".
year	integer	optional	Filter to a calendar year (monthly/seasonal/annual/record_days).
month	integer	optional	Filter to a month (monthly report).
range	integer	optional	Number of years to cover: with year (or met_year) set, returns year..year+range; without, returns the last N years.
season_months	string	optional	Season for the seasonal report (Dec-Jan-Feb, Mar-Apr-May, ...).
met_year	integer	optional	Meteorological year (met_year_annual / annual_outlook).
decade	integer	optional	Decade for projections/likely_scenarios (e.g. 2050).
flood_threshold	string	optional	Flood severity threshold for projections/likely_scenarios.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,10}$",
      "description": "Station ID. Water-level/met stations use 7-digit numeric IDs (e.g. \"9414290\" San Francisco); current stations use alphanumeric IDs (e.g. \"cb0102\"). Find stations with noaa_search_stations or noaa_find_nearest_stations."
    },
    "report": {
      "type": "string",
      "enum": [
        "daily",
        "monthly",
        "seasonal",
        "annual",
        "met_year_annual",
        "annual_outlook",
        "projections",
        "record_days",
        "likely_scenarios",
        "daily_likelihoods"
      ],
      "default": "annual",
      "description": "Which HTF report to retrieve (see tool description)."
    },
    "start_date": {
      "type": "string",
      "description": "YYYYMMDD — required for report \"daily\"."
    },
    "end_date": {
      "type": "string",
      "description": "YYYYMMDD — required for report \"daily\"."
    },
    "year": {
      "type": "integer",
      "description": "Filter to a calendar year (monthly/seasonal/annual/record_days)."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Filter to a month (monthly report)."
    },
    "range": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of years to cover: with year (or met_year) set, returns year..year+range; without, returns the last N years."
    },
    "season_months": {
      "type": "string",
      "enum": [
        "DJF",
        "MAM",
        "JJA",
        "SON"
      ],
      "description": "Season for the seasonal report (Dec-Jan-Feb, Mar-Apr-May, ...)."
    },
    "met_year": {
      "type": "integer",
      "description": "Meteorological year (met_year_annual / annual_outlook)."
    },
    "decade": {
      "type": "integer",
      "description": "Decade for projections/likely_scenarios (e.g. 2050)."
    },
    "flood_threshold": {
      "type": "string",
      "enum": [
        "minor",
        "moderate",
        "major"
      ],
      "description": "Flood severity threshold for projections/likely_scenarios."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "station"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

astro_get_moon_phase

Get the moon phase for a date (or each day of a date range if end_date is given): phase name (New Moon, Waxing Crescent, ...), illuminated fraction, age in days within the 29.53-day cycle, distance (km), apparent diameter (degrees), and waxing/waning. Tide context: spring tides (largest range) occur just after new and full moons; neap tides after quarter moons. Computed locally — no NOAA data involved.

Parameters5

date	string	optional	Date in YYYY-MM-DD format. Defaults to today.
end_date	any	optional	Optional range end (YYYY-MM-DD): returns one entry per day from date through end_date.
latitude	number	optional	Optional latitude for distance/diameter precision.
longitude	number	optional	Longitude in decimal degrees (-180 to 180).
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date in YYYY-MM-DD format. Defaults to today."
    },
    "end_date": {
      "$ref": "#/properties/date",
      "description": "Optional range end (YYYY-MM-DD): returns one entry per day from date through end_date."
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Optional latitude for distance/diameter precision."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

astro_get_next_moon_phase

Find the date(s) of the next occurrence(s) of a principal moon phase (New Moon, First Quarter, Full Moon, Last Quarter) from a starting date. Use for: "when is the next full moon?", planning around spring tides (which follow new/full moons by 1–2 days).

Parameters4

phase	string	required	Which principal phase to find.
date	string	optional	Search start date (YYYY-MM-DD). Defaults to today.
count	integer	optional	How many occurrences to return.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "phase": {
      "type": "string",
      "enum": [
        "New Moon",
        "First Quarter",
        "Full Moon",
        "Last Quarter"
      ],
      "description": "Which principal phase to find."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Search start date (YYYY-MM-DD). Defaults to today."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 24,
      "default": 1,
      "description": "How many occurrences to return."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "phase"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

astro_get_sun_times

Get sunrise, sunset, solar noon, dawn/dusk (civil), nautical dawn/dusk, astronomical dawn/dusk, golden hour, and day length for a location and date (or each day of a range if end_date is given). Times are ISO UTC unless an IANA timezone is provided. At high latitudes some events may be null (e.g. no astronomical night in summer). Computed locally.

Parameters6

latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
date	string	optional	Date in YYYY-MM-DD format. Defaults to today.
end_date	any	optional	Optional range end: one entry per day.
timezone	string	optional	IANA timezone for output times (e.g. "America/New_York"). Defaults to UTC ISO timestamps.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date in YYYY-MM-DD format. Defaults to today."
    },
    "end_date": {
      "$ref": "#/properties/date",
      "description": "Optional range end: one entry per day."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone for output times (e.g. \"America/New_York\"). Defaults to UTC ISO timestamps."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

astro_get_sun_position

Get the sun's position for a date, time, and location: azimuth (degrees clockwise from north as rendered here), altitude above the horizon (degrees), plus approximate declination and right ascension. Use for: shadow/lighting analysis, solar exposure. Computed locally with suncalc; declination/RA are approximate.

Parameters5

latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
date	string	optional	Date in YYYY-MM-DD format. Defaults to today.
time	string	optional	Time of day (HH:MM[:SS], interpreted in the local runtime timezone). Defaults to now.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date in YYYY-MM-DD format. Defaults to today."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
      "description": "Time of day (HH:MM[:SS], interpreted in the local runtime timezone). Defaults to now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

astro_get_next_sun_event

Find the next occurrence(s) of a sun event (sunrise, sunset, dawn, dusk, solarNoon, night, nightEnd, goldenHourStart, goldenHourEnd, nauticalDawn, nauticalDusk, astronomicalDawn, astronomicalDusk) at a location from a starting date. Use for: "when is sunset today?", planning golden-hour photography or dawn fishing around tide windows.

Parameters7

event	string	required	Sun event to find.
latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
date	string	optional	Search start date. Defaults to today.
count	integer	optional	How many occurrences to return.
timezone	string	optional	IANA timezone for output times (e.g. "America/New_York"). Defaults to UTC ISO timestamps.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "enum": [
        "sunrise",
        "sunset",
        "dawn",
        "dusk",
        "solarNoon",
        "night",
        "nightEnd",
        "goldenHourStart",
        "goldenHourEnd",
        "nauticalDawn",
        "nauticalDusk",
        "astronomicalDawn",
        "astronomicalDusk"
      ],
      "description": "Sun event to find."
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Search start date. Defaults to today."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 1,
      "description": "How many occurrences to return."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone for output times (e.g. \"America/New_York\"). Defaults to UTC ISO timestamps."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "event",
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

nws_get_wind_forecast

Get the NWS hourly wind FORECAST (speed, gust, direction — plus wave height where the grid carries it) for a latitude/longitude. Data comes from the NWS forecast grid (api.weather.gov gridpoints — numeric NDFD values, not display strings). Horizon is up to ~7 days (156 hours), starting at the current hour. US and territories only. Wave height appears for marine/nearshore gridpoints; swell/period fields are typically only populated for open-ocean points. Units: english = knots and feet (default), metric = m/s and meters. Direction is degrees true, the direction the wind blows FROM. This is FORECAST data. For observed (measured) wind at a NOAA station right now, use noaa_get_meteorological_data (product "wind"). For the official marine text forecast (Coastal Waters Forecast narrative with small-craft advisories), use nws_get_marine_forecast.

Parameters5

latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
hours	integer	optional	Forecast hours to return, starting at the current hour (max 156 ≈ 7 days; the grid may end sooner).
units	string	optional	Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems.
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "hours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 156,
      "default": 24,
      "description": "Forecast hours to return, starting at the current hour (max 156 ≈ 7 days; the grid may end sooner)."
    },
    "units": {
      "type": "string",
      "enum": [
        "english",
        "metric"
      ],
      "default": "english",
      "description": "Unit system. english: feet, °F, knots (wind AND currents), nautical miles. metric: meters, °C, m/s for wind but cm/s for currents, kilometers. Air pressure is millibars and salinity is PSU in BOTH systems."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

nws_get_marine_forecast

Get the official NWS Coastal Waters Forecast (CWF) narrative for the marine zone covering a latitude/longitude — day-part wind/seas text ("SE winds 10 to 15 kt... Bay waters choppy"), including Small Craft Advisories. The point must lie in (or very near) US coastal waters; CWF zones extend roughly 20-60 NM offshore. Returns the zone's segment from the latest bulletin plus the office-wide synopsis. For numeric hourly wind values use nws_get_wind_forecast; for observed wind at a NOAA station use noaa_get_meteorological_data (product "wind").

Parameters3

latitude	number	required	Latitude in decimal degrees (-90 to 90).
longitude	number	required	Longitude in decimal degrees (-180 to 180).
response_format	string	optional	Output format: "markdown" for a readable summary table, "json" for the complete structured payload.

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in decimal degrees (-90 to 90)."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in decimal degrees (-180 to 180)."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: \"markdown\" for a readable summary table, \"json\" for the complete structured payload."
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

noaa_get_reference_guide

Get curated reference documentation for NOAA CO-OPS concepts and parameters. Topics: - products: Every NOAA CO-OPS data product and which tool serves it - datums: Vertical datums (MLLW, MSL, IGLD...) and station applicability - units: What english vs metric means per measurement (incl. cm/s currents) - time_zones: gmt / lst / lst_ldt semantics and restrictions - intervals: Valid interval values per product family - station_types: Station type filters and station ID formats - data_limits: Maximum date-range span per product - quality_flags: Data quality fields (v/s/f/q), flag letters, HH/H/L/LL - date_formats: Accepted date formats and parameter combinations - marine_forecast: NWS wind & marine forecast tools vs CO-OPS observations Consult this before constructing unusual requests — especially "datums" (which vertical reference to use and station applicability), "units" (english/metric asymmetries like cm/s current speeds), and "data_limits" (maximum date spans per product).

Parameters1

topic

string

required

Reference topic to retrieve.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "products",
        "datums",
        "units",
        "time_zones",
        "intervals",
        "station_types",
        "data_limits",
        "quality_flags",
        "date_formats",
        "marine_forecast"
      ],
      "description": "Reference topic to retrieve."
    }
  },
  "required": [
    "topic"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perigee_whoami

Show how this MCP connection is authenticated: the Perigee account it is linked to (if any), how it signed in (OAuth connector or API key), its rate-limit tier, and the requests-per-minute limit. Use when the user asks which account they're connected as, why they're rate limited, or whether their sign-in worked.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md10 KBView on GitHub

🌊 NOAA Tides & Currents MCP Server

A Model Context Protocol server for NOAA CO-OPS Tides and Currents data

Built by Cardin Labs · Hosted at Perigee

Water levels · tide predictions · currents · marine weather · station metadata · tidal datums · harmonic constituents · sea level trends & projections · high tide flooding · sun & moon calculations

Quick Start

bash

# Run immediately with npx
npx @ryancardin/noaa-tides-currents-mcp-server

# Or the short alias
npx noaa-mcp

Claude Desktop / Claude Code configuration

json

{
  "mcpServers": {
    "noaa": {
      "command": "npx",
      "args": ["-y", "@ryancardin/noaa-tides-currents-mcp-server"]
    }
  }
}

Claude Code one-liner:

bash

claude mcp add noaa -- npx -y @ryancardin/noaa-tides-currents-mcp-server

HTTP mode (optional)

bash

npx noaa-mcp --http --port 3000   # stateless streamable HTTP at http://localhost:3000/mcp

No API key is required — NOAA's CO-OPS APIs are open.

Tools (25)

Observations & Predictions (Data API)

Tool	What it does
`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

Station Discovery & Metadata (Metadata API)

Tool	What it does
`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)

Climate & Derived Products (DPAPI)

Tool	What it does
`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

Astronomy (computed locally)

Tool	What it does
`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

Wind & Marine Forecasts (NWS Weather API)

Tool	What it does
`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

Reference

Tool	What it does
`noaa_get_reference_guide`	Curated NOAA reference: products, datums, units, time zones, intervals, station types, data limits, quality flags, date formats, marine forecasts

Every tool supports response_format: "markdown" (readable tables with units spelled out — the default) or "json" (complete structured payload), and attaches structured content for MCP clients that consume it.

Resources

noaa://guide/getting-started — workflow recipes and common pitfalls
noaa://reference/{topic} — the ten reference topics above as pinnable resources

Prompts

tide_report — tide report for a place/station and date
boating_conditions — pre-departure briefing: tides, currents, wind, daylight
station_flood_risk — flood risk profile: HTF history, extremes, trends, projections
station_overview — everything a station offers

The Nuances (handled for you)

These are the things that make NOAA's API tricky — this server encodes them:

Datums matter. Heights are meaningless without a vertical reference. MLLW (chart datum) is the default; stations differ in which datums they support (Great Lakes use IGLD/LWD and have no tide predictions). noaa_get_station_datums gives the conversion table.
Units are asymmetric. metric means m/s for wind but cm/s for currents; air pressure is millibars and salinity PSU in both systems. Every response labels its units.
Per-product request-span limits (4 days for 1-minute data, 31 days for 6-minute, 1 year hourly, 10 years for hilo predictions...) are validated client-side with actionable messages before hitting NOAA.
Two station ID schemes. Water-level/met stations are 7-digit numeric (9414290); current stations are alphanumeric (cb0102).
Reference vs subordinate stations. Subordinate (S) prediction stations only support hilo predictions, derived by offsets from a reference (R) station.
daily_mean requires local standard time and only exists for Great Lakes stations — enforced automatically.
Quality flags decoded. Preliminary vs verified data, sigma, flag alphabets (which differ between preliminary and verified!), and HH/H/L/LL tide types are explained inline.
Predictions are astronomical — storm surge is not included; compare with observed water levels.
Station directory is cached (6 h) so nearest-station searches don't refetch thousands of records.

Usage Examples

"When is high tide in Boston tomorrow?"

noaa_find_nearest_stations (type tidepredictions) → 8443970 BOSTON
noaa_get_tide_predictions (interval hilo) → high/low times & heights above MLLW

"How strong will the current be in the Cape Cod Canal this afternoon?"

noaa_find_nearest_stations (type currentpredictions)
noaa_get_current_predictions (interval max_slack) → max flood/ebb (knots) and slack times

"How often does Providence flood now vs 20 years ago, and what's projected for 2050?"

noaa_get_high_tide_flooding (report annual, range 25)
noaa_get_high_tide_flooding (report projections, decade 2050)
noaa_get_sea_level_trends + noaa_get_sea_level_rise_projections

Development

bash

npm install
npm run build        # tsc → dist/
npm test             # vitest unit tests (validation, formatting, astronomy)
npm run test:live    # end-to-end smoke test against the live NOAA API
npm run inspector    # MCP Inspector against dist/index.js
npm run dev          # tsx src/index.ts

Architecture

code

src/
├── index.ts            # entry point: stdio (default) or --http streamable HTTP
├── constants.ts        # API base URLs, timeouts, cache TTLs, response limits
├── client/             # shared HTTP layer (retry/backoff, error mapping) + TTL cache
├── validation/         # date normalization + per-product span limit enforcement
├── format/             # unit labeling, flag legends, markdown/json response shaping
├── schemas/            # shared Zod field schemas with nuance-carrying descriptions
├── services/           # Data API, Metadata API, DPAPI, moon & sun services
├── tools/              # 25 tool registrations grouped by domain
├── resources/          # noaa:// reference resources
├── prompts/            # workflow prompt templates
└── reference/          # curated NOAA reference content

Data sources:

Data API — api.tidesandcurrents.noaa.gov/api/prod/datagetter
Metadata API — api.tidesandcurrents.noaa.gov/mdapi/prod/webapi
Derived Product API — api.tidesandcurrents.noaa.gov/dpapi/prod/webapi
Astronomy — suncalc, computed locally

License

NOAA data is provided by the NOAA Center for Operational Oceanographic Products and Services (CO-OPS). This project is not affiliated with or endorsed by NOAA.

Install

Tools (26)

noaa_get_water_levelsnoaa_get_water_level_summariesnoaa_get_tide_predictionsnoaa_get_currentsnoaa_get_current_predictionsnoaa_get_meteorological_datanoaa_search_stationsnoaa_find_nearest_stations

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "noaa-tides-and-currents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ryancardin/noaa-tides-currents-mcp-server@2.1.0"
      ]
    }
  }
}

NOAA Tides & Currents MCP Server (io.github.RyanCardin15/noaa-tides-and-currents-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

noaa_get_water_levels

noaa_get_water_level_summaries

noaa_get_tide_predictions

noaa_get_currents

noaa_get_current_predictions

noaa_get_meteorological_data

noaa_search_stations

noaa_find_nearest_stations

noaa_get_station_info

noaa_get_station_datums

noaa_get_harmonic_constituents

noaa_get_prediction_offsets

noaa_get_sea_level_trends

noaa_get_sea_level_rise_projections

noaa_get_extreme_water_levels

noaa_get_top_ten_water_levels

noaa_get_high_tide_flooding

astro_get_moon_phase

astro_get_next_moon_phase

astro_get_sun_times

astro_get_sun_position

astro_get_next_sun_event

nws_get_wind_forecast

nws_get_marine_forecast

noaa_get_reference_guide

perigee_whoami

🌊 NOAA Tides & Currents MCP Server

Quick Start

Claude Desktop / Claude Code configuration

HTTP mode (optional)

Tools (25)

Observations & Predictions (Data API)

Station Discovery & Metadata (Metadata API)

Climate & Derived Products (DPAPI)

Astronomy (computed locally)

Wind & Marine Forecasts (NWS Weather API)

Reference

Resources

Prompts

The Nuances (handled for you)

Usage Examples

Development

Architecture

License

Install

Related servers