Surf MCP Server

What is Surf MCP Server?

Surf MCP Server is an MCP server that retrieves tide information for any location using latitude and longitude. It supports date-specific queries and provides detailed tide data including high/low tides, water heights, and station information. It is designed for surfers and anyone who needs tide data via the Storm Glass API.

How to use Surf MCP Server?

Clone the repository, install dependencies with uv sync, then add the server to your Claude desktop configuration file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json). Set the STORMGLASS_API_KEY environment variable. Invoke the get_tides tool with latitude, longitude, and date (YYYY-MM-DD) parameters.

Key features of Surf MCP Server

• Fetch tide information for any location using latitude and longitude.
• Support for date-specific tide queries.
• Detailed tide data including high/low tides and station information.
• Automatic time zone handling (UTC).
• Robust error handling for API failures, invalid coordinates, and missing keys.

Use cases of Surf MCP Server

• Determine the optimal surfing time by analyzing incoming tides (about 2 hours before high tide) at a favorite beach.
• Evaluate tide data accuracy by checking station distance from the requested location.

FAQ from Surf MCP Server

What are the prerequisites for using Surf MCP Server?

Python 3.x and a Storm Glass API key are required. The API key is obtained from stormglass.io (free tier available).

How does the tool handle API usage limits?

The free Storm Glass tier allows 10 requests per day. Paid plans from 500 to 25,000 requests/day are available. Choose a plan based on your usage.

Where does the tide data come from?

All tide data is fetched from the Storm Glass API. The server does not store any local data; it queries the API on each request.

What transport does the server use?

The server runs over stdio, as is standard for MCP servers. Debugging is best done with the MCP Inspector.

How is authentication handled?

The Storm Glass API key is provided via the STORMGLASS_API_KEY environment variable in the MCP server configuration. No other authentication is required.