Surf MCP Server

@ravinahp

About Surf MCP Server

An MCP server for people who surf waves and the web.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "surf-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K