# Stormglass MCP

> Stormglass connects professional-grade environmental data directly to your AI agent. It fetches high-resolution forecasts for weather, tide levels, marine biology metrics, and astronomy points for any coordinate on Earth. Use `get_weather_point` or `get_bio_point` to build predictive models for logistics, climate research, and outdoor planning. This is the single source for global environmental data.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** weather-api, marine-data, tide-forecast, oceanography, astronomy

## Description

This server connects your AI agent directly to professional-grade environmental data for any spot on Earth. It fetches high-resolution forecasts covering weather, tide levels, marine life metrics, and even celestial events—all in one place. You'll build predictive models for everything from complex maritime logistics to deep climate research.

When you use this server, your agent accesses five specialized tools that pull real-time or forecasted data across multiple critical domains:

**Weather Forecasting:** You can get live weather data using `get_weather_point`. This tool gives you wind speed and wave height measurements for a specified coordinate, plus the air temperature. If you're planning an offshore survey, you check these points to ensure conditions are safe. The agent gathers this information so your client knows exactly what it's dealing with.

**Tide & Sea Level Analysis:** For any coastal operation, knowing the water level is everything. You use `get_tide_extremes_point` to calculate the absolute maximum and minimum high and low tides expected at a location over time. If you need to know when the docks will be completely submerged or highest, this is your tool. Furthermore, if you're monitoring continuous changes—say, tracking coastal erosion or river flow over hours—you run `get_tide_sea_level_point`. This function returns detailed sea level measurements at set time intervals, letting you see how the water height shifts minute by minute.

**Marine Ecology Monitoring:** Need to know what's actually floating out there? You use `get_bio_point` to pull biological data. It retrieves current marine metrics like oxygen levels or chlorophyll concentrations right at a specific point. This is vital for scientific analysis, letting you track the health of an ecosystem without having to deploy physical sensors yourself.

**Astronomy & Celestial Events:** If your operation depends on the sun or moon—like solar panel deployment or deep-sea photography—you use `get_astronomy_point`. It fetches precise data points for sunrise, sunset, and all the moon phases. You'll get accurate times for when the celestial bodies will be above the horizon at any coordinate.

**Putting it Together:** The server lets your agent analyze sea levels across specific time intervals using `get_tide_sea_level_point`, while simultaneously checking predicted extreme tides with `get_tide_extremes_point`. You can combine these water movement metrics with wind and wave data from `get_weather_point` to forecast the exact operational window for a vessel. For climate modeling, you pair biological readings—like oxygen levels via `get_bio_point`—with historical weather patterns fetched through multiple points in time.

Your agent doesn't just get single numbers; it pulls coordinated data. You can cross-reference the sunset times from `get_astronomy_point` with expected wave heights from `get_weather_point` to plan a deep-sea recovery mission that must happen after dark but before the tide drops too low. If you need to model how changes in chlorophyll concentration correlate with sea level fluctuations, you pull both datasets using their respective tools and run your prediction. The ability to query both upcoming predictions and historical data points across all these metrics—all linked by specific time stamps—means you never have to leave this single source for global environmental information.

## Tools

### get_astronomy_point
Fetches precise data points about sunrise, sunset, and moon phases for a given location.

### get_bio_point
Retrieves current marine biological metrics like oxygen levels or chlorophyll concentrations at a specific point.

### get_tide_extremes_point
Calculates the maximum and minimum high and low tides expected for a given coastal location.

### get_tide_sea_level_point
Returns detailed sea level measurements at specific time intervals, useful for continuous monitoring.

### get_weather_point
Gathers weather data including wind speed and wave height for a specified coordinate.

## Prompt Examples

**Prompt:** 
```
Get the current wind speed and wave height for San Francisco (lat 37.7749, lng -122.4194).
```

**Response:** 
```
I've retrieved the weather data for San Francisco. Currently, the wind speed is 12 knots and the wave height is 1.5 meters according to NOAA data.
```

**Prompt:** 
```
What are the high and low tides in Lisbon for the next 24 hours?
```

**Response:** 
```
Checking tide extremes for Lisbon... The next high tide is expected at 2:45 PM (1.2m) and the next low tide at 9:15 PM (0.3m).
```

**Prompt:** 
```
Show me the sunrise and sunset times for Tokyo today.
```

**Response:** 
```
For Tokyo today, the sun rose at 6:12 AM and is expected to set at 5:45 PM. The moon is currently in its Waxing Gibbous phase.
```

## Capabilities

### Fetch real-time weather forecasts
The agent retrieves wind speed, wave height, and air temperature for a specified latitude and longitude.

### Determine predicted high/low tides
The system calculates the expected highest and lowest sea levels at an area over time.

### Monitor precise marine ecology metrics
You pull biological data, including oxygen or chlorophyll concentration, for scientific analysis.

### Calculate solar and lunar events
The agent returns accurate times for sunrise, sunset, moon phase, and related celestial measurements.

### Analyze sea level over specific intervals
This tool fetches continuous data showing the exact sea height at set time points near a coast.

## Use Cases

### Designing a coastal construction schedule
A civil engineer needs to know when it's safe to build foundations. They ask their agent for the expected sea level using `get_tide_sea_level_point` across three months, cross-referencing that with maximum wind speeds from `get_weather_point`. The agent provides a timeline showing construction windows that avoid high tides and strong winds.

### Optimizing marine research routes
A scientist needs to track nutrient availability. They use the agent to query both the current biological metrics (`get_bio_point`) and the tide cycle (`get_tide_extremes_point`). The resulting data pinpoints specific time windows where oxygen levels are optimal for sampling.

### Planning an international yacht race
The captain asks their agent to analyze the route. The system combines wave height and air temperature from `get_weather_point` with predicted celestial timing from `get_astronomy_point`. This gives a full picture of conditions, not just wind speed.

### Assessing historical environmental trends
A climate researcher wants to show how ocean acidity has changed. They use the agent to query both biological metrics (`get_bio_point`) and sea level data using ISO 8601 timestamps, allowing for a direct comparison of past conditions against modern forecasts.

## Benefits

- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]

## How It Works

The bottom line is that your AI client handles the complex API calls; you just ask for the data using natural language prompts.

1. Subscribe to the Stormglass server and input your unique API key into your AI client.
2. Call one of the exposed tools (e.g., `get_weather_point`), providing precise coordinates and required dates/times.
3. The agent receives a structured JSON output containing the requested environmental data, which it can then use for calculation or display.

## Frequently Asked Questions

**How do I use `get_weather_point`?**
You call `get_weather_point` by providing the specific latitude and longitude. The tool returns current and forecasted wind speed, wave height, and air temperature for that exact spot.

**What is the difference between `get_tide_extremes_point` and `get_tide_sea_level_point`?**
`get_tide_extremes_point` gives you only the predicted high/low peaks. Use `get_tide_sea_level_point` if you need to track sea level height across continuous, measured time intervals.

**Can I predict solar events with `get_astronomy_point`?**
Yes, `get_astronomy_point` calculates sunrise, sunset, moonrise, and moonset times. It also provides the current moon phase (e.g., Waxing Gibbous).

**What kind of data does `get_bio_point` return?**
`get_bio_point` returns critical marine metrics, such as chlorophyll concentrations and dissolved oxygen levels, which are vital for oceanographic studies.

**What credentials do I need before running a tool like `get_weather_point`?**
You'll need your unique Stormglass API Key. Enter this key into your Vinkius Marketplace subscription settings. Your AI client automatically uses it for every data request.

**Does `get_tide_sea_level_point` require specific coordinate formatting?**
No, it expects standard decimal degrees for coordinates. Provide latitude and longitude as floating-point numbers (e.g., 34.0522, -118.2437).

**Are there rate limits when calling `get_weather_point` repeatedly?**
Yes, the API enforces standard rate limiting. If you exceed the allowed calls per minute, your agent will receive a 429 error code. Wait an appropriate interval and try again.

**Can `get_tide_extremes_point` pull historical tide records?**
Yes, it accepts ISO 8601 formatted timestamps for time ranges. You must include the specific start and end date/time in your request parameters.

**Can I get specific wave and wind data for a maritime location?**
Yes! Use the `get_weather_point` tool. You can specify parameters like `windSpeed` and `waveHeight` in the params string to get high-resolution data for your coordinates.

**How do I find the next high and low tides for a coastal city?**
Simply use the `get_tide_extremes_point` tool with the latitude and longitude of the location. It will return the timing and height of the upcoming tide extremes.

**Does the server provide biological data like chlorophyll levels?**
Yes, the `get_bio_point` tool allows you to fetch biological marine data including chlorophyll, iron, nitrate, oxygen, and phytoplankton levels for any coordinate.