CO-OPS MCP Server

MCP server providing AI assistants with access to NOAA CO-OPS water levels, tides, currents, and coastal oceanographic data.

No API key required — all CO-OPS APIs are free and public.

Features

• Station Discovery — List, search, and find nearest CO-OPS stations by type, state, or coordinates
• Water Levels — Real-time and historical observed water levels with multiple datum references
• Tide Predictions — Harmonic tide predictions (6-min, hourly, or high/low)
• Meteorological Data — Wind, air/water temperature, pressure, humidity, visibility, and more
• Currents — Current observations and predictions from PORTS stations
• Derived Products — Extreme water levels, flood statistics, sea level trends, storm events, tidal datums

Quick Start

Install with uv

git clone https://github.com/oceanmodeling/ocean-mcp.git
cd ocean-mcp/servers/coops-mcp
uv sync

Configure your MCP client

Add to your MCP settings:

{
  "mcpServers": {
    "coops": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/coops-mcp", "python", "-m", "coops_mcp"]
    }
  }
}

Or if installed as a package:

{
  "mcpServers": {
    "coops": {
      "command": "uvx",
      "args": ["coops-mcp"]
    }
  }
}

Available Tools

Usage Examples

Ask naturally — the right tool will be selected automatically:

• "Get current water levels at The Battery, NY" → coops_get_water_levels(station_id="8518750", date="latest")
• "Find tide stations near Miami Beach" → coops_find_nearest_stations(latitude=25.77, longitude=-80.13, station_type="waterlevels")
• "What were the highest water levels ever recorded at San Francisco?" → coops_get_extreme_water_levels(station_id="9414290")
• "Show me wind data for Key West today" → coops_get_meteorological(station_id="8724580", product="wind", date="today")
• "What are the flood statistics for The Battery?" → coops_get_flood_stats(station_id="8518750")
• "Get tide predictions for Charleston, SC for next week" → coops_get_tide_predictions(station_id="8665530", begin_date="...", end_date="...")

API Reference

This server wraps three NOAA CO-OPS APIs:

• Data API — Observations and predictions
• Metadata API — Station information
• Derived Product API — Historical/statistical products

Development

# Install dev dependencies
uv sync

# Run unit tests
uv run pytest tests/test_models.py tests/test_utils.py tests/test_client.py -v

# Run live integration tests (makes real API calls)
uv run pytest tests/test_live.py -v -s

# Start the server
uv run python -m coops_mcp

License

MIT