Servidor MCP
NOAA Tides and Currents
io.github.RyanCardin15/noaa-tides-and-currents-mcp
Qué hace este MCP
Provides NOAA tide, current, water-level, weather, flooding, sea-level, and astronomical data for coastal locations.
Capacidades
Herramientas
26
herramientas
astro_get_moon_phase
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', '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', 'maximum': 90, 'minimum': -90, 'description': 'Optional latitude for distance/diameter precision.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
astro_get_next_moon_phase
Get Next Moon Phase Occurrence
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).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['phase'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Search start date (YYYY-MM-DD). Defaults to today.'}, 'count': {'type': 'integer', 'default': 1, 'maximum': 24, 'minimum': 1, 'description': 'How many occurrences to return.'}, 'phase': {'enum': ['New Moon', 'First Quarter', 'Full Moon', 'Last Quarter'], 'type': 'string', 'description': 'Which principal phase to find.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
astro_get_next_sun_event
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event', 'latitude', 'longitude'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Search start date. Defaults to today.'}, 'count': {'type': 'integer', 'default': 1, 'maximum': 30, 'minimum': 1, 'description': 'How many occurrences to return.'}, 'event': {'enum': ['sunrise', 'sunset', 'dawn', 'dusk', 'solarNoon', 'night', 'nightEnd', 'goldenHourStart', 'goldenHourEnd', 'nauticalDawn', 'nauticalDusk', 'astronomicalDawn', 'astronomicalDusk'], 'type': 'string', 'description': 'Sun event to find.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'timezone': {'type': 'string', 'description': 'IANA timezone for output times (e.g. "America/New_York"). Defaults to UTC ISO timestamps.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
astro_get_sun_position
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], 'properties': {'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.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
astro_get_sun_times
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], '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: one entry per day.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'timezone': {'type': 'string', 'description': 'IANA timezone for output times (e.g. "America/New_York"). Defaults to UTC ISO timestamps.'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_find_nearest_stations
Find Nearest NOAA 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.)
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], 'properties': {'type': {'enum': ['waterlevels', 'historicwl', 'met', 'waterlevelsandmet', 'tidepredictions', 'harcon', 'datums', 'supersededdatums', 'benchmarks', 'supersededbenchmarks', 'currents', 'historiccurrents', 'surveycurrents', 'currentpredictions', 'cond', 'watertemp', 'physocean', 'tcoon', '1minute', 'airgap', 'visibility', 'highwater', 'lowwater'], 'type': 'string', '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', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Number of stations to return.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'max_distance_km': {'type': 'number', 'description': 'Optional cutoff radius in kilometers.', 'exclusiveMinimum': 0}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_current_predictions
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'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.'}, 'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'interval': {'enum': ['max_slack', 'h', '1', '6', '10', '30', '60'], 'type': 'string', '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': {'enum': ['default', 'speed_dir'], 'type': 'string', 'default': 'default', 'description': '"default" = flood/ebb-axis velocity (Velocity_Major signed: + flood, - ebb); "speed_dir" = speed and compass direction.'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_currents
Get Observed 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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'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.'}, 'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'expand_detailed': {'type': 'boolean', 'default': False, 'description': 'Include ADCP beam diagnostics (echo1-4, corr1-4) per record.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_extreme_water_levels
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'levelType': {'enum': ['high', 'low'], 'type': 'string', 'description': 'High extremes (default) or low.'}, 'extremeType': {'enum': ['annuals', 'monthlies'], 'type': 'string', 'description': 'Extreme statistics basis: annual (default) or monthly extremes.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_harmonic_constituents
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).
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'bin': {'type': 'integer', 'minimum': 1, 'description': 'For current stations: restrict to one depth bin.'}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_high_tide_flooding
Get High Tide Flooding Data
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'year': {'type': 'integer', 'description': 'Filter to a calendar year (monthly/seasonal/annual/record_days).'}, 'month': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Filter to a month (monthly report).'}, 'range': {'type': 'integer', 'description': 'Number of years to cover: with year (or met_year) set, returns year..year+range; without, returns the last N years.', 'exclusiveMinimum': 0}, 'decade': {'type': 'integer', 'description': 'Decade for projections/likely_scenarios (e.g. 2050).'}, 'report': {'enum': ['daily', 'monthly', 'seasonal', 'annual', 'met_year_annual', 'annual_outlook', 'projections', 'record_days', 'likely_scenarios', 'daily_likelihoods'], 'type': 'string', 'default': 'annual', 'description': 'Which HTF report to retrieve (see tool description).'}, '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.'}, 'end_date': {'type': 'string', 'description': 'YYYYMMDD â\x80\x94 required for report "daily".'}, 'met_year': {'type': 'integer', 'description': 'Meteorological year (met_year_annual / annual_outlook).'}, 'start_date': {'type': 'string', 'description': 'YYYYMMDD â\x80\x94 required for report "daily".'}, 'season_months': {'enum': ['DJF', 'MAM', 'JJA', 'SON'], 'type': 'string', 'description': 'Season for the seasonal report (Dec-Jan-Feb, Mar-Apr-May, ...).'}, 'flood_threshold': {'enum': ['minor', 'moderate', 'major'], 'type': 'string', 'description': 'Flood severity threshold for projections/likely_scenarios.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_meteorological_data
Get Meteorological & Sensor 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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station', 'product'], 'properties': {'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, 'product': {'enum': ['air_temperature', 'water_temperature', 'wind', 'air_pressure', 'air_gap', 'conductivity', 'visibility', 'humidity', 'salinity'], 'type': 'string', 'description': 'Sensor product to retrieve.'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'interval': {'enum': ['6', 'h'], 'type': 'string', 'default': '6', 'description': '"6" = 6-minute observations (default), "h" = hourly.'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_prediction_offsets
Get Prediction Offsets (Subordinate Stations)
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'kind': {'enum': ['tide', 'current'], 'type': 'string', 'default': 'tide', 'description': '"tide" = tidepredoffsets; "current" = currentpredictionoffsets.'}, '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.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_reference_guide
Get NOAA API 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).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic'], 'properties': {'topic': {'enum': ['products', 'datums', 'units', 'time_zones', 'intervals', 'station_types', 'data_limits', 'quality_flags', 'date_formats', 'marine_forecast'], 'type': 'string', 'description': 'Reference topic to retrieve.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic', 'guide'], 'properties': {'guide': {'type': 'string'}, 'topic': {'enum': ['products', 'datums', 'units', 'time_zones', 'intervals', 'station_types', 'data_limits', 'quality_flags', 'date_formats', 'marine_forecast'], 'type': 'string'}}, 'additionalProperties': False}
noaa_get_sea_level_rise_projections
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).
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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': {'enum': ['all', 'low', 'intermediate-low', 'intermediate', 'intermediate-high', 'high', 'extreme'], 'type': 'string', 'default': 'intermediate', 'description': 'Emissions/rise scenario from the 2022 Interagency report.'}, 'projection_year': {'type': 'integer', 'maximum': 2150, 'minimum': 2000, 'description': 'Filter to a single decade year (e.g. 2050).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_sea_level_trends
Get Relative 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).
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'affil': {'enum': ['US', 'Global'], 'type': 'string', 'description': 'Network filter when listing multiple stations.'}, '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.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_station_datums
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'epoch': {'enum': ['current', 'superseded'], 'type': 'string', 'default': 'current', 'description': '"current" = present NTDE (1983â\x80\x932001); "superseded" = prior epoch values.'}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_station_info
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, 'expand': {'type': 'array', 'items': {'enum': ['details', 'sensors', 'floodlevels', 'benchmarks', 'products', 'notices', 'disclaimers', 'bins', 'deployments'], 'type': 'string'}, 'description': 'Sub-resources to embed inline (availability varies by station type).'}, '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.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_tide_predictions
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'datum': {'enum': ['MHHW', 'MHW', 'MTL', 'MSL', 'MLW', 'MLLW', 'NAVD', 'STND', 'IGLD', 'LWD', 'CRD'], 'type': 'string', 'default': 'MLLW', '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."}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'interval': {'enum': ['hilo', 'h', '1', '5', '6', '10', '15', '30', '60'], 'type': 'string', '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).'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_top_ten_water_levels
Get Top Ten / Peak 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?".
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'year': {'type': 'integer', 'description': 'For peakwaterlevels: filter to one year.'}, 'datum': {'enum': ['STND', 'MHHW', 'MHW', 'MSL', 'MTL', 'MLW', 'MLLW', 'NAVD', 'IGLD', 'LWD'], 'type': 'string', 'default': 'MHHW', 'description': 'Reference datum for reported heights (MHHW is standard for flood context).'}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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': {'enum': ['toptenwaterlevels', 'peakwaterlevels'], 'type': 'string', 'default': 'toptenwaterlevels', 'description': '"toptenwaterlevels" = ten highest on record; "peakwaterlevels" = peak event records.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_water_levels
Get Observed 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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station'], 'properties': {'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'datum': {'enum': ['MHHW', 'MHW', 'MTL', 'MSL', 'MLW', 'MLLW', 'NAVD', 'STND', 'IGLD', 'LWD', 'CRD'], 'type': 'string', 'default': 'MLLW', '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."}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'interval': {'enum': ['1', '6', 'hourly'], 'type': 'string', '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).'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_get_water_level_summaries
Get Water Level Summaries (High/Low, Daily, Monthly)
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['station', 'product'], 'properties': {'date': {'enum': ['today', 'latest', 'recent'], 'type': 'string', 'description': 'Shortcut window: "today" = midnight to now, "latest" = single most recent reading, "recent" = last 72 hours. Mutually exclusive with begin_date/end_date/range.'}, 'datum': {'enum': ['MHHW', 'MHW', 'MTL', 'MSL', 'MLW', 'MLLW', 'NAVD', 'STND', 'IGLD', 'LWD', 'CRD'], 'type': 'string', 'default': 'MLLW', '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."}, 'range': {'type': 'integer', 'description': 'Number of hours. With begin_date: hours forward. With end_date: hours back. Alone: hours back from now.', 'exclusiveMinimum': 0}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, 'product': {'enum': ['high_low', 'daily_mean', 'daily_max_min', 'monthly_mean'], 'type': 'string', '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).'}, '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.'}, 'end_date': {'type': 'string', 'description': 'End date/time. Same formats as begin_date.'}, 'time_zone': {'enum': ['gmt', 'lst', 'lst_ldt'], 'type': 'string', '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.'}, 'begin_date': {'type': 'string', 'description': 'Start date/time. Formats: yyyyMMdd, "yyyyMMdd HH:mm", MM/dd/yyyy, or ISO yyyy-MM-dd[THH:mm].'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
noaa_search_stations
Search NOAA 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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Case-insensitive substring of the station name.'}, 'type': {'enum': ['waterlevels', 'historicwl', 'met', 'waterlevelsandmet', 'tidepredictions', 'harcon', 'datums', 'supersededdatums', 'benchmarks', 'supersededbenchmarks', 'currents', 'historiccurrents', 'surveycurrents', 'currentpredictions', 'cond', 'watertemp', 'physocean', 'tcoon', '1minute', 'airgap', 'visibility', 'highwater', 'lowwater'], 'type': 'string', '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', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Maximum stations to return.'}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter US state/territory code, e.g. "CA".'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Pagination offset.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
nws_get_marine_forecast
Get Marine Text Forecast (NWS)
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").
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], 'properties': {'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
nws_get_wind_forecast
Get Wind Forecast (NWS)
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['latitude', 'longitude'], 'properties': {'hours': {'type': 'integer', 'default': 24, 'maximum': 156, 'minimum': 1, 'description': 'Forecast hours to return, starting at the current hour (max 156 â\x89\x88 7 days; the grid may end sooner).'}, 'units': {'enum': ['english', 'metric'], 'type': 'string', '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.'}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (-90 to 90).'}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (-180 to 180).'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': 'Output format: "markdown" for a readable summary table, "json" for the complete structured payload.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['_response'], 'properties': {'_response': {'type': 'object', 'required': ['contractVersion', 'status'], 'properties': {'status': {'type': 'string', 'const': 'complete'}, 'contractVersion': {'type': 'string', 'const': '2026-09-29.1'}}, 'additionalProperties': False}}, 'additionalProperties': True}
perigee_whoami
Which Perigee account is this connection using?
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'note': {'type': 'string'}, 'tier': {'type': 'string'}, 'error': {'type': 'string'}, 'method': {'enum': ['oauth', 'api_key'], 'type': 'string'}, 'account': {'type': 'object', 'required': ['email', 'displayName'], 'properties': {'email': {'type': ['string', 'null']}, 'displayName': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'apiKeyName': {'type': 'string'}, 'authenticated': {'type': 'boolean'}, 'limitPerMinute': {'type': 'number'}, 'connectedClient': {'type': 'string'}}, 'additionalProperties': False}
Historial
Cambios recientes en herramientas
Modificado
perigee_whoami
1 de October de 2026 a las 02:48
Modificado
noaa_get_reference_guide
1 de October de 2026 a las 02:48
Modificado
nws_get_marine_forecast
1 de October de 2026 a las 02:48
Modificado
nws_get_wind_forecast
1 de October de 2026 a las 02:48
Modificado
astro_get_next_sun_event
1 de October de 2026 a las 02:48
Modificado
astro_get_sun_position
1 de October de 2026 a las 02:48
Modificado
astro_get_sun_times
1 de October de 2026 a las 02:48
Modificado
astro_get_next_moon_phase
1 de October de 2026 a las 02:48
Modificado
astro_get_moon_phase
1 de October de 2026 a las 02:48
Modificado
noaa_get_high_tide_flooding
1 de October de 2026 a las 02:48
Modificado
noaa_get_top_ten_water_levels
1 de October de 2026 a las 02:48
Modificado
noaa_get_extreme_water_levels
1 de October de 2026 a las 02:48
Modificado
noaa_get_sea_level_rise_projections
1 de October de 2026 a las 02:48
Modificado
noaa_get_sea_level_trends
1 de October de 2026 a las 02:48
Modificado
noaa_get_prediction_offsets
1 de October de 2026 a las 02:48
Modificado
noaa_get_harmonic_constituents
1 de October de 2026 a las 02:48
Modificado
noaa_get_station_datums
1 de October de 2026 a las 02:48
Modificado
noaa_get_station_info
1 de October de 2026 a las 02:48
Modificado
noaa_find_nearest_stations
1 de October de 2026 a las 02:48
Modificado
noaa_search_stations
1 de October de 2026 a las 02:48
Modificado
noaa_get_meteorological_data
1 de October de 2026 a las 02:48
Modificado
noaa_get_current_predictions
1 de October de 2026 a las 02:48
Modificado
noaa_get_currents
1 de October de 2026 a las 02:48
Modificado
noaa_get_tide_predictions
1 de October de 2026 a las 02:48
Modificado
noaa_get_water_level_summaries
1 de October de 2026 a las 02:48
Modificado
noaa_get_water_levels
1 de October de 2026 a las 02:48
Añadido
perigee_whoami
17 de September de 2026 a las 12:49
Añadido
noaa_get_reference_guide
17 de September de 2026 a las 12:49
Añadido
nws_get_marine_forecast
17 de September de 2026 a las 12:49
Añadido
nws_get_wind_forecast
17 de September de 2026 a las 12:49
Descubrir
Servidores MCP similares
gisgp
io.github.uponex/gisgp
Provides GIS geocoding, routing, spatial transformations, ArcGIS layer inspection and export, and location due diligence for haza…
UK Environmental Intelligence MCP Server from MCPBundles
com.mcpbundles/uk-environmental-intelligence
Provides UK environmental intelligence covering flood warnings, river and groundwater readings, bathing water quality, ecology ob…
Maptiler
io.github.pipeworx-io/maptiler
Provides MapTiler geocoding, coordinate conversion, and point or route elevation data using map and terrain datasets.
Open Meteo
io.github.pipeworx-io/open-meteo
Provides global weather forecasts, historical reanalysis, geocoding, air-quality, marine, and flood data for specified locations.
Nasa Eonet
io.github.pipeworx-io/nasa-eonet
Retrieves NASA EONET natural hazard events such as wildfires, storms, volcanoes, floods, and landslides, including geographic and…
Coordinates
io.github.pipeworx-io/coordinates
Performs geographic coordinate calculations including bounding boxes, centroids, midpoints, and point-in-box tests.
Openweather
io.github.pipeworx-io/openweather
Provides geocoding, current weather, forecasts, and air-quality data for cities and geographic coordinates.
Usgs National Map
io.github.pipeworx-io/usgs-national-map
Accesses USGS National Map data and services for geographic and geospatial information.