# Storm Glass MCP

> Storm Glass Marine & Weather MCP Server provides global marine and weather data right where you work. Your agent pulls real-time wave heights, tide predictions, water temperatures, and astronomical data from leading meteorological sources (NOAA, MET Office). Whether you're planning a ship route or tracking ocean currents, this server turns complex environmental forecasts into simple questions for your AI client.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** marine-weather, tide-data, oceanic-forecasting, meteorological-data, real-time-weather, astronomical-data

## Description

Storm Glass Marine & Weather MCP Server gives you global marine intelligence right in your agent's workflow. Your AI client uses this server to pull real-time, forecast data—everything a mariner needs from leading meteorological sources like NOAA and the MET Office.

When you need **Marine Weather Data**, the `get_marine_weather` tool provides detailed forecasts for any specific geographic coordinate. You get readings on wave height and swell direction, along with current water temperatures. This isn't just a snapshot; it’s a forecast that tells you what to expect over time. It handles both real-time conditions and future projections, giving you the environmental context needed whether you’re planning a route or checking safety margins.

When calculating **Tide Extremes**, simply call `get_tide_extremes`. This function retrieves the predicted times and heights for both high tide and low tide at any coastal spot. You can pin down exactly when the water will peak and when it'll drop, which is critical knowledge for loading docks, navigating shallow inlets, or scheduling beach operations. The server pulls these crucial predictions based on your chosen location.

If you need to figure out the celestial timing, use `get_astronomy_data`. This tool gathers specific dates and timings for sunrise, sunset, moon phases, and when the moon will rise. You get precise data points that track the sun and moon's movements over time for a given location.

Beyond basic weather, you can also monitor **Ocean Chemistry** using environmental markers like chlorophyll and nutrient levels. This helps gauge the overall health of the water at your coordinates. When you need to **Plan Offshore Operations**, the server consolidates multiple data streams into one place. You can pull together tide predictions, wave forecasts, and even current information to build a single report for site planning or safety reviews.

The whole point is that you don't gotta switch between specialized APIs. Your agent manages the entire conversation with this server. Just ask your AI client a natural question—like, “What’s the tide schedule and wave height near Miami next Tuesday?”—and it handles pulling all those complex environmental forecasts into one answer.

## Tools

### get_astronomy_data
Gets specific sun and moon data for a given location.

### get_marine_weather
Provides detailed marine weather forecasts, including wave height and water temp, for coordinates.

### get_tide_extremes
Retrieves the predicted high and low tide times and heights for a specific location.

## Prompt Examples

**Prompt:** 
```
Check the wave height and water temp for Honolulu (21.3069, -157.8583).
```

**Response:** 
```
Retrieving marine data for Honolulu... Currently, the wave height is 1.2 meters and the water temperature is 25.4°C. The swell is coming from the North-West. Would you like to see the forecast for the next few hours?
```

**Prompt:** 
```
What are the high and low tide times for London Bridge today?
```

**Response:** 
```
I've fetched the tide extremes for the London Bridge area. High tide is expected at 14:45 (3.2m) and low tide at 21:10 (0.5m). Would you like the full schedule for the week?
```

**Prompt:** 
```
Get the current sunrise and moon phase for Rio de Janeiro.
```

**Response:** 
```
Retrieving astronomical data... For Rio de Janeiro, sunrise was at 06:12. The current moon phase is a Waxing Gibbous (72% illumination).
```

## Capabilities

### Get Marine Weather Data
Retrieves real-time and forecast wave height, swell, and water temperature for a specific geographic coordinate.

### Calculate Tide Extremes
Fetches the predicted times and heights for both high and low tides at any given coastal location.

### Retrieve Astronomical Data
Gathers specific dates and timings for sunrise, sunset, moon phases, and moonrise events.

### Monitor Ocean Chemistry
Checks environmental markers like chlorophyll and nutrient levels to gauge oceanic health at a location.

### Plan Offshore Operations
Consolidates multiple data points (tide, wave, current) into a single report for site planning or safety checks.

## Use Cases

### Planning a Deep-Sea Dive Site
A research team needs to know the optimal window for a deep-sea deployment. They ask their agent: 'What are the tide extremes and wave forecasts near coordinates X, Y?' The agent runs `get_tide_extremes` and `get_marine_weather`, telling them exactly when the water is lowest (best access) and if the swell is manageable.

### Checking Port Access During Low Visibility
A shipping company needs to confirm safe entry into a port. They ask their agent for the current marine weather, specifically checking wave height. The agent uses `get_marine_weather` to verify conditions before authorizing passage, preventing costly delays.

### Analyzing Fishing Ground Changes
An environmental consultant wants to see if nutrient levels correlate with the moon cycle. They ask the agent to combine oceanic bio data and `get_astronomy_data`. The resulting report helps them prove a correlation between lunar phases and local chlorophyll spikes.

### Scheduling an Island Inspection
A construction foreman needs to know when it’s safest to build. He asks his agent for the tide extremes at the site coordinates, knowing that high tides make access impossible. The agent runs `get_tide_extremes` and provides a narrow window of opportunity.

## Benefits

- **Marine Point Forecasts:** Stop guessing on route safety. Use `get_marine_weather` to get immediate wave height and water temperature readings for any point on Earth. Your agent gives you the forecast in plain text, not a spreadsheet.
- **Tidal Planning:** Cut out hours of manual chart consulting. The `get_tide_extremes` tool pulls guaranteed high and low tide times and heights, letting you plan coastal access with precision.
- **Full Cycle View:** You don't need three separate API calls. This server lets your agent correlate wave data (`get_marine_weather`) with moon phases (`get_astronomy_data`), giving a complete picture of environmental forces at play.
- **Deep Environmental Tracking:** Track more than just weather. Use the tools to monitor oceanic bio markers and nutrient levels, crucial for research into climate shifts or aquaculture health.
- **Immediate Operational Readiness:** When you need to know if an offshore site is safe *right now*, your agent combines multiple inputs—tides, waves, and current conditions—into one actionable status report.

## How It Works

The bottom line is: You talk to your agent, and it talks to Storm Glass, giving you an immediate data report.

1. Subscribe to the Storm Glass server and plug in your API key.
2. Tell your AI client exactly what data you need (e.g., 'Tide times for Miami, Florida').
3. The agent executes the necessary tool calls and gives you a single, formatted answer.

## Frequently Asked Questions

**How do I check wave height for a specific spot using get_marine_weather?**
Just ask your agent to run `get_marine_weather` and provide the exact coordinates. The tool pulls real-time data, including wave height, swell direction, and water temperature.

**Can I use get_tide_extremes for more than just high/low marks?**
Yes. `get_tide_extremes` gives the full cycle prediction for a location, helping you plan operations around specific times of low water or maximum depth.

**Does get_astronomy_data help with marine planning?**
Absolutely. `get_astronomy_data` provides sunrise/sunset and moon phases. This helps you plan work around natural light conditions, which often affects visible water movement.

**What if I need to check both tides and waves? Do I run multiple tools?**
No. You just ask your agent for both things in one prompt. It automatically calls `get_tide_extremes` and `get_marine_weather` and combines the results into a single, easy-to-read report.

**How do I set up authentication when calling get_tide_extremes?**
You must provide your Storm Glass API Key as an environment variable or configuration parameter. Your AI client uses this key to authorize every request, ensuring secure access to the tide data.

**What happens if I use get_marine_weather for a coordinate with no known weather data?**
The system returns a structured error message detailing why the location failed. This allows your agent to gracefully handle bad inputs or prompt you for an alternative area.

**Are there rate limits when frequently calling get_astronomy_data?**
Yes, the API enforces usage quotas to maintain service stability. Always check the Storm Glass documentation for current rate limits and implement exponential backoff in your workflow logic.

**What specific environmental metrics does get_marine_weather include besides wave height?**
In addition to wave height and swell, it delivers water temperature and often includes data on nutrient levels like chlorophyll. This gives you a full picture of the local ocean environment.

**Can I get the water temperature in the Mediterranean Sea?**
Yes! Use the `get_marine_weather` tool and provide the latitude and longitude for the specific point in the Mediterranean. It will return the latest water temperature along with other marine data.

**How can I check the tide schedule for a coastal city?**
Use the `get_tide_extremes` tool with the coordinates of the target city. The response will provide the timestamps and heights for the next few high and low tide events.

**Does this server provide sunrise and sunset times?**
Yes. The `get_astronomy_data` tool retrieves sunrise, sunset, moonrise, and moonset times, as well as the current moon phase for any given location.