{
  "markdown": "# shouldigo-surf-mcp\n\nMCP server for [Should I Go?](https://shouldigo.surf) — real-time surf conditions for 5,000+ beaches worldwide.\n\nUse 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.\n\n## Setup\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"shouldigo-surf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"shouldigo-surf-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add shouldigo-surf -- npx -y shouldigo-surf-mcp\n```\n\n## Tools\n\n### check_conditions\n\nGet real-time surf conditions for a specific beach.\n\n**Input:** `{ \"spotId\": \"pipeline\" }`\n\n**Returns:** Score (0-100), verdict (yes/no/maybe), wave height, wind, water temp, trend, and board recommendation.\n\n### find_nearest_spot\n\nFind the nearest surf spot to given coordinates.\n\n**Input:** `{ \"lat\": 21.66, \"lon\": -158.05 }` (optional — auto-detects if omitted)\n\n### list_spots\n\nList all available surf spots, optionally filtered by country.\n\n**Input:** `{ \"country\": \"Australia\" }` (optional)\n\n## Example\n\nAsk Claude:\n\n> \"What are the surf conditions at Pipeline right now?\"\n\n> \"Find me the nearest surf spot to Sydney and check if it's worth going\"\n\n> \"List all surf spots in Portugal\"\n\n## API\n\nThis MCP server calls the public [Should I Go? API](https://api.shouldigo.surf). No API key needed.\n\nRate limited to 60 requests per 15 minutes. For higher limits, email support@shouldigo.surf.\n\n## License\n\nMIT\n",
  "bytes": 1626,
  "sha": "917ef4147308ef6bf2f14f35f7386c2feecfb3ead15a225b98ecf442d9e1872e",
  "repo_slug": "orlench/shouldigo-surf-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_orlench_shouldigo_surf_b8f36bf1/readme"
}