Metadata-Version: 2.4
Name: vdatum-mcp
Version: 0.1.1
Summary: MCP server for vertical datum conversions using coastalmodeling-vdatum
Project-URL: Homepage, https://github.com/mansurjisan/ocean-mcp
Project-URL: Repository, https://github.com/mansurjisan/ocean-mcp
Author-email: Mansur Jisan <mansur.jisan@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: coastal,mcp,mllw,model-context-protocol,navd88,noaa,vdatum,vertical-datum
Requires-Python: >=3.11
Requires-Dist: mcp[cli]<2,>=1.0.0
Requires-Dist: numpy<3,>=1.26
Requires-Dist: pyproj<4,>=3.7
Description-Content-Type: text/markdown

# vdatum-mcp

<!-- mcp-name: io.github.mansurjisan/vdatum-mcp -->

MCP server for vertical datum conversions using [coastalmodeling-vdatum](https://github.com/oceanmodeling/coastalmodeling-vdatum).

Converts elevations between NAVD88, MLLW, MLW, MHW, MHHW, LMSL, xGEOID20b, IGLD85, and LWD.

`coastalmodeling-vdatum` isn't published to PyPI, so the small amount of its
code this server actually calls is vendored directly (CC0-licensed; see
`src/vdatum_mcp/_vendor/coastalmodeling_vdatum/VENDORED.md` for the exact
commit and attribution) rather than installed as an external dependency.

## Tools

| Tool | Description |
|------|-------------|
| `vdatum_convert` | Convert elevation values between vertical datums |
| `vdatum_list_datums` | List all supported vertical datums |

## Installation

```bash
pip install -e .
```

## Example Queries via CORAL

```
Convert 1.5 meters from NAVD88 to MLLW at The Battery (40.7, -74.0)
What vertical datums are supported?
Convert these water levels from MLLW to NAVD88: lat 30,26,27.5 lon -80,-75,-77.5 z 0.5,1.0,0.3
```
