Surf

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

python

19

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ravinahp-surf-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/Code/surf-mcp",
        "run",
        "surf-mcp"
      ],
      "env": {
        "STORMGLASS_API_KEY": "your_api_key_here"
      }
    }
  }
}

You run Surf MCP Server to fetch tide information for any location by latitude, longitude, and date. This MCP server automates tide data retrieval and presents structured results, including high/low tides and station context, with automatic UTC handling for consistent timing.

How to use

You will access tide information through an MCP client that calls the available tool named get_tides. Provide the location coordinates as floating point numbers and the date in YYYY-MM-DD format. The server returns a tide list with times in UTC, tide type (HIGH/LOW), height, and nearby station details such as its name and distance from your location.

Useful patterns include querying for a specific day at a chosen beach by supplying your exact coordinates and date, then reviewing the resulting tide times to identify the best surfing window, typically during incoming tides near high tide.

How to install

Prerequisites you must have before installing: Python 3.x and a Storm Glass API key.

Clone the project directory and navigate into it.
Install dependencies using the uv tool.
Build or sync dependencies if required by your setup.

Additional sections

Configure the server as an MCP server by using the provided runtime command and environment variable setup. The configuration snippet below will run the Surf MCP Server via uv and set the Storm Glass API key in the environment.

{
  "surf-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/YOUR_USERNAME/Code/surf-mcp",
      "run",
      "surf-mcp"
    ],
    "env": {
      "STORMGLASS_API_KEY": "your_api_key_here"
    }
  }
}

Notes on usage and security

Keep your Storm Glass API key secure. Do not expose it in public code or logs. If you rotate keys, update the environment value in your MCP configuration accordingly.

The server uses UTC for all times, so convert local times to UTC if needed when interpreting results.

Available tools

get_tides

Fetch tide information for a specific location and date by providing latitude, longitude, and a date string. Returns a structured list of tide times (UTC), types (HIGH/LOW), heights, and station information.