Tools / Ocean & Tides
Ocean & Tides icon

Ocean & Tides

Tides, waves, and ocean forecasts

Tides, waves, sea temperature, ocean currents, marine alerts, and real station readings for any coastal location worldwide. Covers beaches, harbors, and open ocean with forecasts, historical statistics, and station reference data.

10 skillsv0.03
Tide Forecast

Get high and low tide times and heights for a NOAA station. Covers US coasts, territories, and Great Lakes. Returns tide predictions for 1-7 days with times and water levels.

Returns: High and low tide times and heights for the requested period
Parameters
station_id *stringNOAA station ID (e.g. "8454000" for Providence, RI). Use find_stations to look up station IDs near a location.
daysnumberNumber of days to forecast (1-7, default 2)
datumstringTidal datum reference (default MLLW). Options: MLLW, MLW, MSL, MHW, MHHW, NAVD
unitsstringUnits: "english" (feet) or "metric" (meters). Default english.
Example
Tides for Providence, RI
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "tide_forecast",
  "input": {
    "station_id": "8454000"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Wave Forecast

Get wave height, swell, and surf conditions for any ocean location worldwide. Returns hourly forecasts including wave height, wave period, wave direction, swell height, swell period, wind wave details, and daily sea surface temperature for up to 7 days.

Returns: Hourly wave and swell forecast with current conditions snapshot, daily summary, and sea surface temperature
Parameters
latitude *numberLatitude of the ocean location (e.g. 33.77 for Huntington Beach)
longitude *numberLongitude of the ocean location (e.g. -118.19 for Huntington Beach)
daysnumberForecast days (1-7, default 3)
Example
Waves at Huntington Beach, CA
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "wave_forecast",
  "input": {
    "latitude": 33.655,
    "longitude": -117.999
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Ocean Conditions

Get sea surface temperature, ocean currents, and water conditions for any ocean location worldwide. Returns current conditions plus hourly forecasts.

Returns: Sea surface temperature and ocean current data with hourly forecast
Parameters
latitude *numberLatitude of the ocean location
longitude *numberLongitude of the ocean location
daysnumberForecast days (1-7, default 2)
Example
Ocean conditions off Miami
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "ocean_conditions",
  "input": {
    "latitude": 25.76,
    "longitude": -80.19
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Find Stations

Find NOAA tide prediction, water level, water temperature, or current prediction stations near a given location. Returns the closest stations with their IDs, names, coordinates, and distance. Use the station ID with tide_forecast, station_conditions, current_predictions, or station_info.

Returns: List of nearby NOAA stations with IDs, names, coordinates, and distance in km
Parameters
latitude *numberLatitude to search near (e.g. 40.7 for New York)
longitude *numberLongitude to search near (e.g. -74.0 for New York)
typestringStation type: "tides" (tide predictions), "waterlevels" (observed), "watertemp" (temperature), "currents" (current predictions)
limitnumberMaximum number of stations to return (default 10)
Example
Find tide stations near New York
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "find_stations",
  "input": {
    "latitude": 40.7,
    "longitude": -74
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Marine Alerts

Get active marine weather alerts and warnings for a location. Covers small craft advisories, gale warnings, storm warnings, hurricane warnings, rip current statements, and tsunami alerts. US coasts only.

Returns: Active marine weather alerts with event type, severity, headline, and detailed description
Parameters
latitude *numberLatitude of the coastal location (US coasts only)
longitude *numberLongitude of the coastal location (US coasts only)
Example
Marine alerts near Cape Cod
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "marine_alerts",
  "input": {
    "latitude": 41.67,
    "longitude": -70
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Beach Report

Complete conditions report for a beach or coastal location. Combines waves, SST, currents, and marine alerts in one snapshot. Global for waves and water temp; US-only for tides and alerts.

Returns: Complete beach conditions: waves, water temp, currents, wind, sea surface temperature range, and marine alerts in one response
Parameters
latitude *numberLatitude of the beach or coastal location
longitude *numberLongitude of the beach or coastal location
daysnumberForecast days (1-3, default 2)
Example
Beach report for Malibu, CA
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "beach_report",
  "input": {
    "latitude": 34.03,
    "longitude": -118.68
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Station Conditions

Get real observed conditions from a NOAA CO-OPS station — actual sensor readings, not forecasts. Returns water temp, wind, air temp, pressure, water level, salinity, humidity, visibility, and conductivity. Unavailable sensors return null.

Returns: Real observed conditions from station sensors: water temp, wind, air temp, pressure, water level, salinity, humidity, visibility, and conductivity
Parameters
station_id *stringNOAA CO-OPS station ID (e.g. "8454000" for Providence, RI). Use find_stations to look up station IDs near a location.
unitsstringUnits: "english" (°F, feet, knots) or "metric" (°C, meters, m/s). Default english.
Example
Current conditions at Providence, RI
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "station_conditions",
  "input": {
    "station_id": "8454000"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Current Predictions

Get ocean current velocity and direction predictions at NOAA current stations. Returns predicted current speed, direction, flood/ebb indicators, and timing. Current stations are different from tide stations — use find_stations with type "currents" to locate them.

Returns: Predicted ocean current velocity, direction, and flood/ebb indicators for the requested period
Parameters
station_id *stringNOAA current station ID (e.g. "PUG1515" for Puget Sound). Use find_stations with type "currents" to look up current station IDs.
daysnumberNumber of days to forecast (1-7, default 2)
unitsstringUnits: "english" (knots) or "metric" (m/s). Default english.
Example
Current predictions for Puget Sound
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "current_predictions",
  "input": {
    "station_id": "PUG1515"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Tidal Statistics

Get monthly mean tidal levels for a NOAA station over a date range. Returns monthly mean high water, low water, mean sea level, tide range, and highest/lowest values for historical analysis.

Returns: Monthly mean tidal levels with statistical summary for historical analysis
Parameters
station_id *stringNOAA station ID (e.g. "8454000" for Providence, RI). Use find_stations to look up station IDs.
start_date *stringStart date in YYYY-MM-DD format (e.g. "2024-01-01")
end_date *stringEnd date in YYYY-MM-DD format (e.g. "2024-12-31")
unitsstringUnits: "english" (feet) or "metric" (meters). Default english.
Example
Monthly tidal means for Providence in 2024
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "tidal_statistics",
  "input": {
    "station_id": "8454000",
    "start_date": "2024-01-01",
    "end_date": "2024-12-31"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Station Info

Get complete reference data for a NOAA station including tidal datums (MHHW, MHW, MSL, MLW, MLLW), flood level thresholds (minor, moderate, major), and top harmonic constituents. Not all stations have all three data types — each is fetched independently.

Returns: Station reference data: tidal datums, flood level thresholds, and harmonic constituents
Parameters
station_id *stringNOAA station ID (e.g. "8454000" for Providence, RI). Use find_stations to look up station IDs.
Example
Reference data for Providence, RI
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "ocean-data",
  "skill": "station_info",
  "input": {
    "station_id": "8454000"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Loading reviews...
Loading activity...
v0.032026-03-22
  • Added current_predictions skill for ocean current velocity and direction at NOAA current stations
  • Added tidal_statistics skill for monthly mean tidal levels and historical analysis
  • Added station_info skill for datums, flood levels, and harmonic constituents
  • Enhanced find_stations with currents station type
  • Enhanced station_conditions with salinity, humidity, visibility, and conductivity products
  • Enhanced wave_forecast and beach_report with daily sea surface temperature min/max
v0.022026-03-22
  • Added station_conditions skill for real observed NOAA CO-OPS station readings
v0.012026-03-22
  • Initial release with 6 skills: tide_forecast, wave_forecast, ocean_conditions, find_stations, marine_alerts, beach_report

Quick Start

MCP (Claude Code)
claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp
REST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"ocean-data","skill":"tide_forecast","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

How do I get tide times for a beach or harbor?

Use `tide_forecast` with a NOAA station ID for high and low tides. It covers US coasts, territories, and Great Lakes, with 1-7 day predictions.

Can I check waves and water conditions outside the US?

Yes. `wave_forecast` and `ocean_conditions` work worldwide for surf, swell, sea temperature, and currents. Tide predictions and marine alerts are US-only.

How do I find the right station ID first?

`find_stations` searches nearby NOAA tide, water level, water temperature, and current stations and returns the IDs you can use in the forecast tools.

What is included in a full beach report?

`beach_report` combines waves, sea surface temperature, currents, wind, and marine alerts into one snapshot so you can check conditions in a single call.