# Marine Weather MCP

> Open-Meteo Marine Weather gives your AI access to real-time and forecasted deep-sea data. It handles wave height, swell components, ocean currents, tides, and sea surface temperature at 5km resolution for maritime planning. Use it to check daily summaries, get hourly forecasts, or monitor current velocity for any coastal route.

## Overview
- **Category:** the-unthinkable
- **Price:** Free
- **Tags:** oceanography, marine-weather, wave-forecasting, tide-data, hydrography

## Description

Your AI client talks directly to Open-Meteo Marine Weather, giving you access to deep-sea data that matters for maritime planning. It handles wave height, swell components, ocean currents, tides, and sea surface temperature—all at 5km resolution. You'll use this server when you need to check daily summaries, pull hourly forecasts, or monitor current velocity across any coastal route.

If you run `get_daily_marine`, you get a single report detailing the max wave height and dominant periods for an entire day, letting you quickly calculate operational summaries. You'll see the maximum expected wave height, dominant wave direction, and average period for that 24-hour window.

When you need to plan specific trips, `get_marine_forecast` provides detailed, hour-by-hour marine wave predictions at 5km resolution. This gives your agent everything it needs to generate hourly navigation forecasts for complex journeys.

To understand the water flow itself, you run `get_ocean_currents`. This tool returns precise data points on ocean currents: the current velocity and direction, plus the sea surface temperature for a specific location. These readings let you model current flow and thermal data across the entire path.

This server equips your agent to manage complex oceanic variables. It pulls together wave metrics like height, period, and direction, separating wind components from swell components so you know exactly what's hitting the hull. You can get granular details on the water movement, tracking current velocity and direction alongside sea surface temperature. The capability lets you pull all these moving parts into a single context for your AI client to act upon.

You don't have to manually cross-reference multiple charts or data sources. Your agent handles the complexity. For fisheries, shipping companies, coastal engineers, yacht clubs, or naval operations, this means one connection gives you full visibility. You can check daily operational readiness using the summary report, plan multi-stage routes with hourly forecasts, and adjust for thermal changes by modeling current flow in real time.

The data isn't just wave height; it includes swell components separately from wind components, giving a much truer picture of what you're dealing with offshore. This level of detail is crucial for anything involving marine travel or coastal construction. It keeps your agent working off the freshest possible metrics, whether that’s tracking the deepest-sea data or verifying localized tide patterns.

It's built for serious work. You get a comprehensive view of the environment—from the surface waves to the deep current shifts. Your AI client processes all these variables automatically so you just get the actionable intelligence you need.

## Tools

### get_marine_forecast
Provides detailed, hourly forecasts of marine wave conditions at 5km resolution for planning specific journeys.

### get_ocean_currents
Returns the current velocity, direction, and sea surface temperature data points for a location.

### get_daily_marine
Retrieves a single summary report detailing the max wave height and dominant periods for an entire day.

## Prompt Examples

**Prompt:** 
```
What are the wave conditions off the coast of Hawaii right now?
```

**Response:** 
```
🌊 **Hawaii North Shore — Current Conditions**

Wave height: 2.8m | Period: 14s
Swell: 2.4m from NW (315°)
Wind waves: 0.6m
Sea surface temp: 25.3°C

Excellent surfing conditions with clean long-period northwest swell.
```

**Prompt:** 
```
Is it safe to sail across the English Channel tomorrow?
```

**Response:** 
```
⚓ **English Channel — Tomorrow**

Wave height: 1.2m (moderate)
Wind waves: 0.8m from SW
Ocean current: 0.3 m/s eastbound
Sea temp: 14.1°C

Conditions are favorable for crossing. Expect moderate chop in the afternoon.
```

**Prompt:** 
```
What's the maximum wave height expected in the North Sea this week?
```

**Response:** 
```
🌊 **North Sea 7-Day Wave Max**

Day 1: 2.1m | Day 2: 1.8m | Day 3: 3.4m ⚠️
Day 4: 4.1m ⚠️ | Day 5: 2.6m | Day 6-7: 1.5m

Storm system on days 3-4 could produce significant wave heights. Exercise caution.
```

## Capabilities

### Calculate daily operational summaries
The agent pulls the maximum expected wave height, dominant wave direction, and average period for a given day.

### Generate hourly navigation forecasts
The system provides detailed, hour-by-hour marine wave predictions at 5km resolution to plan specific trips.

### Model current flow and thermal data
You retrieve the precise velocity, direction, and sea surface temperature of ocean currents for a location.

## Use Cases

### Planning a transatlantic crossing
A captain asks their agent: 'Is the passage safe next week?' The agent runs `get_daily_marine` to check the overall trend, then uses `get_marine_forecast` for hourly specifics. Finally, it calls `get_ocean_currents` to calculate expected drift over time, giving a true safety window.

### Checking local fishing ground conditions
A fisheries manager needs to know if the current day's swell is too low. They use `get_daily_marine` for the overview and then specifically check the SST via `get_ocean_currents` to confirm optimal feeding temperatures, maximizing catch potential.

### Assessing port entry risks
An engineer needs to know if a new pier will withstand seasonal waves. They run multiple calls to `get_marine_forecast` over several days and cross-reference the data with current velocity from `get_ocean_currents` to calculate combined maximum stress.

### Evaluating an immediate salvage operation
The agent runs `get_ocean_currents` immediately to get real-time flow and temperature. It then uses this data with the hourly forecast (`get_marine_forecast`) to determine the narrowest, safest window for recovery.

## Benefits

- Safety: Combine `get_marine_forecast` and `get_ocean_currents`. You don't just see the wave height; you know how strong currents will push your vessel off course, which is critical for safety margins.
- Planning Efficiency: Instead of manually checking multiple charts for a week-long trip, `get_daily_marine` gives you immediate maximum expected wave heights and dominant periods for quick risk assessments.
- Data Depth: This server separates swell from wind waves in the forecast. Knowing this difference allows captains to plan routes around specific energy sources, not just general choppy water.
- Environmental Awareness: Use `get_ocean_currents` to track sea surface temperature (SST). This helps fisheries predict optimal deep-sea fishing grounds or monitor thermal changes near reefs.
- Workflow Clarity: By structuring the data into three distinct tools (`get_daily_marine`, `get_marine_forecast`, `get_ocean_currents`), your agent can handle complex requests without getting lost in raw, unstructured CSV dumps.

## How It Works

The bottom line is that it lets your AI client synthesize three distinct data streams—daily stats, hourly forecasts, and current flow—into one coherent operational briefing.

1. First, you tell your AI client the area and time frame. You might need to check the daily summary using `get_daily_marine`.
2. Next, if you're planning a specific crossing, you run `get_marine_forecast` for hourly wave details. Then, you cross-reference this with `get_ocean_currents` to see how the water is actually moving.
3. The agent combines these datasets into an actionable report, giving you a complete picture of safety risks and travel windows.

## Frequently Asked Questions

**Does `get_marine_forecast` include swell components?**
Yes, the forecast explicitly separates wind-wave and swell components. This detail is crucial because swell energy often dictates vessel stability more than local wind waves.

**What data does `get_ocean_currents` provide?**
`get_ocean_currents` gives you the current velocity, direction, and sea surface temperature for a location. It’s necessary to predict how external forces will affect your route.

**Can I check long-term trends with `get_daily_marine`?**
Yes, you can use `get_daily_marine` to see the maximum expected wave height and dominant periods over a sequence of days, giving a quick overview of sustained weather patterns.

**Is this better than just using a standard NOAA data feed?**
Yes. While NOAA is authoritative, this MCP server structures that raw data into three distinct tools (`get_daily_marine`, etc.) and presents it through an agent interface, making the complex information immediately actionable for your client.

**How precise is the data I get when running `get_marine_forecast`?**
The forecast operates at 5km resolution. This means your AI client receives highly localized data points, making it useful for planning routes across specific areas rather than just general coastal views.

**What input parameters are required to use `get_ocean_currents`?**
You must provide specific geographic coordinates (latitude and longitude) when calling `get_ocean_currents`. The tool uses these fixed points to calculate the current velocity and sea surface temperature for that exact location.

**Are there rate limits when I frequently call functions like `get_daily_marine`?**
Yes, consistent high-volume usage is subject to standard API rate limiting. We recommend implementing an exponential backoff strategy in your agent workflow if you anticipate making more than a few calls per minute.

**What format does the output from `get_marine_forecast` come in?**
All tool outputs, including those from `get_marine_forecast`, are delivered as structured JSON. This makes parsing the data simple and reliable for your AI client to consume.

**How accurate are the wave forecasts?**
Wave data is sourced from **ECMWF WAM, DWD EWAM, and NCEP GFS Wave** models at 5km resolution. Accuracy is excellent for open ocean but limited near coastlines due to resolution constraints.