# Swell Window Analysis AI Agent Connect

> Geometric analysis of swell windows and coastal shadowing.

## Overview
- **Category:** geospatial
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OaaUsP5w4rKTlZ19dX0llCesvuSpImRknQB6TQT5/ai-agent-connect
- **Tags:** swell, bathymetry, coastline, ocean, geometry

## Description

This MCP server provides geometric tools to analyze how ocean swell interacts with specific coastlines. It calculates the available swell window based on bathymetry, identifies blocked directions caused by offshore obstacles like islands or headlands using `analyze_obstruction_shadows`, and determines the most effective wave direction via `identify_optimal_direction`. It is designed for surf forecasting and coastal engineering analysis.

## Tools

### calculate_swell_window
Determine the range of wave directions that can reach the coastline

### analyze_obstruction_shadows
Identify which swell directions are blocked by external physical features

### get_break_exposure_summary
Provide a high-level overview of the break's receptivity to different swell patterns

### identify_optimal_direction
Find the single best swell direction for maximum energy at the break

## Prompt Examples

**Prompt:** 
```
What is the swell window for a coastline at 90 degrees with this bathymetry: [{"x": 10, "y": 5}]?
```

**Response:** 
```
The available swell window is between 45 and 135 degrees with a total width of 90 degrees.
```

**Prompt:** 
```
Will an island at {x: 50, y: 50} with radius 5 block a swell coming from 180 degrees?
```

**Response:** 
```
Yes, the island at those coordinates creates a shadow zone that blocks the 180-degree swell direction.
```

**Prompt:** 
```
What is the optimal swell direction for a coast at 0 degrees if available angles are [45, 90, 135] and 90 is blocked?
```

**Response:** 
```
The optimal swell direction is 45 degrees.
```

## Frequently Asked Questions

**How do I calculate the available swell directions?**
You can use the `calculate_swell_window` tool by providing the coastline bearing and a JSON string representing the bathymetry profile.

**Can this tool account for islands blocking waves?**
Yes, the `analyze_obstruction_shadows` tool identifies blocked angles and shadow zones created by offshore obstacles.

**What is the best way to find the most energetic swell direction?**
Use the `identify_optimal_direction` tool, which finds the angle closest to perpendicular to the coastline that is not blocked by obstacles.
