Shouldigo Surf
MCP server for Should I Go? — real-time surf conditions for 73+ beaches worldwide
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y shouldigo-surf-mcp
MCP client config
{
"mcpServers": {
"shouldigo-surf": {
"command": "npx",
"args": [
"-y",
"shouldigo-surf-mcp"
]
}
}
}shouldigo-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 support@shouldigo.surf.
License
MIT
