About Shouldigo.surf
Shouldigo.surf is an MCP server for checking real-time surf conditions at beaches worldwide. It helps surfers find nearby spots and assess whether conditions are suitable, with scores, forecasts, and board recommendations.
Key features
- 01Check real-time beach conditions
- 02Find the nearest surf spot
- 03List spots by country
- 04View score and surf verdict
- 05See trend and board recommendation
Use cases
- 01Check conditions before a surf session
- 02Find surf spots near given coordinates
- 03Browse surf spots in a country
MCP support
The MCP server provides tools to check conditions for a beach, find the nearest spot, and list spots. MCP-compatible clients can use these tools to retrieve surf information.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
3Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| spotId | string | Yes | The spot identifier, e.g. "pipeline", "bells_beach", "tel_aviv_maaravi". Use list_spots to find valid IDs. |
Details
From the project READMEshouldigo-surf-mcp
MCP server for Should I Go? — real-time surf conditions for 5,000+ beaches worldwide.
Use this with Claude Desktop, Claude Code, or any MCP-compatible client to check surf conditions, find nearby spots, and get a score + verdict on whether it's worth paddling out.
Setup
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"shouldigo-surf": {
"command": "npx",
"args": ["-y", "shouldigo-surf-mcp"]
}
}
}
Claude Code
claude mcp add shouldigo-surf -- npx -y shouldigo-surf-mcp
Tools
check_conditions
Get real-time surf conditions for a specific beach.
Input: { "spotId": "pipeline" }
Returns: Score (0-100), verdict (yes/no/maybe), wave height, wind, water temp, trend, and board recommendation.
find_nearest_spot
Find the nearest surf spot to given coordinates.
Input: { "lat": 21.66, "lon": -158.05 } (optional — auto-detects if omitted)
list_spots
List all available surf spots, optionally filtered by country.
Input: { "country": "Australia" } (optional)
Example
Ask Claude:
"What are the surf conditions at Pipeline right now?"
"Find me the nearest surf spot to Sydney and check if it's worth going"
"List all surf spots in Portugal"
API
This MCP server calls the public Should I Go? API. No API key needed.
Rate limited to 60 requests per 15 minutes. For higher limits, email [email protected].
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.