surfline-mcp

Minimal Python MCP server with one tool: get_surf_forecast.

It fetches both Surfline forecast endpoints:

• conditions
• rating

The spot is fixed by environment variable (SURFLINE_SPOT_ID) so this server is effectively single-spot.

Setup

cd surfline-mcp
uv sync

Run (stdio MCP server)

cd surfline-mcp
export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uv run surfline-mcp

Run via uvx (from GitHub)

export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uvx --from git+https://github.com/ivoytov/surfline-mcp surfline-mcp

Nanobot MCP config (uvx)

{
  "tools": {
    "mcpServers": {
      "surfline": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/ivoytov/surfline-mcp", "surfline-mcp"],
        "env": {
          "SURFLINE_SPOT_ID": "5842041f4e65fad6a7708852"
        }
      }
    }
  }
}

Tool

get_surf_forecast(days=3)

Returns:

• spot_id
• days
• daily_forecast[] with:
  • forecastDay
  • dayToWatch
  • headline
  • observation
  • rating_summary.dominant_key
  • rating_summary.min_value
  • rating_summary.max_value
  • rating_summary.avg_value
  • rating_windows[] as compact 3-hour snapshots:
    • local_hour
    • key
    • value