Shouldigo.surf
About
Real-time surf conditions for 5,000+ beaches worldwide. Check scores, wave height, wind, water temp, and get a verdict on whether it's worth paddling out.
Details
- Author
- orlench
- Downloads
- 119
- Categories
- Other
Jump to
- Real‑time surf data for 5,000+ global beaches
- Score (0‑100) and verdict (yes/no/maybe)
- Wave height, wind, water temperature, and trend
- Board recommendation based on conditions
- No API key required
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Shouldigo.surfCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the server to your Claude Desktop configuration or use claude mcp add. Once configured, ask natural‑language questions about surf conditions. The server exposes three tools: check_conditions (by spot ID), find_nearest_spot (by coordinates or auto‑detect), and list_spots (optionally filtered by country).
check_conditions
Get real-time surf conditions for a specific beach. Returns score (0-100), verdict (yes/no/maybe), wave height, wind, water temp, trend forecast, and board recommendation.
find_nearest_spot
Find the nearest surf spot to given coordinates and return its current conditions. If no coordinates provided, auto-detects location.
list_spots
List all available surf spots. Optionally filter by country name.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"shouldigo.surf": {
"shouldigo-surf": {
"command": "npx",
"args": [
"-y",
"shouldigo-surf-mcp"
]
}
}
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
