# Swell Refraction Calculator AI Agent Connect

> Predict wave refraction, height changes, and breaking stability using Snell's and Green's Laws.

## Overview
- **Category:** mathematics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_gT6G8UjvCdwse6bTPFFwmncTfwk4wRc6NHCtOdW4/ai-agent-connect
- **Tags:** waves, ocean, refraction, physics, meteorology

## Description

This MCP server provides deterministic oceanographic calculations to model how swell energy transforms as it moves from deep to shallow water. By applying Snell's Law for refraction and Green's Law for height transformation, it allows AI agents to predict wave direction changes, height multipliers, and wave steepness. Use `get_refracted_wave_properties` to calculate full physical transformations, `get_refraction_summary` for quick comparisons, or `validate_swell_stability` to check if a wave is approaching its breaking limit.

## Tools

### get_refracted_wave_properties
Calculates wave refraction properties

### get_refraction_summary
Provides refraction summary

### validate_swell_stability
Checks swell stability

## Prompt Examples

**Prompt:** 
```
Calculate the properties of a swell with a 20 degree angle in deep water, moving at 15 m/s, into shallow water moving at 5 m/s, with an initial height of 2 meters and a wavelength of 15 meters.
```

**Response:** 
```
The wave will refract to an angle of 9.59 degrees. The predicted shallow water height is 2.58 meters, with a wave steepness of 0.17. Since the steepness is above 0.14, the wave is predicted to break.
```

**Prompt:** 
```
Give me a summary of the refraction for a 10m swell at 12 m/s, 30 degrees angle, moving into water with 4 m/s speed.
```

**Response:** 
```
The wave height multiplier is 1.85 and the angle change is 21.45 degrees.
```

**Prompt:** 
```
Is a wave with a steepness of 0.12 stable?
```

**Response:** 
```
Yes, the wave is stable with a safety margin of 0.02.
```

## Frequently Asked Questions

**What physical laws does this server use?**
The server utilizes Snell's Law to calculate the refraction angle and Green's Law to approximate the change in wave height as it enters shallower water.

**How is wave breaking determined?**
A wave is flagged as breaking if its calculated steepness exceeds the stability threshold of 0.14.

**Can I use custom stability thresholds?**
Yes, the `validate_swell_stability` tool allows you to provide a custom target threshold for steepness checks.