Surf MCP Server
An MCP server for people who surf waves and the web.
Overview
Surf MCP Server is a tool designed for surfers to fetch tide information for specific locations, helping them to surf waves effectively by providing real-time data.
To use Surf MCP Server, clone the repository from GitHub, install the necessary dependencies, and configure it with your Storm Glass API key. You can then query tide information using latitude, longitude, and date parameters.
- Fetch tide information using latitude and longitude. - Support for date-specific tide queries. - Detailed tide data including high/low tides and station information. - Automatic time zone handling (UTC).
- Determining the best surfing times based on tide conditions.
- Fetching tide data for planning surf trips.
- Monitoring tide changes for specific locations.
Add to your AI client
Use these steps to connect Surf MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"surf-mcp-ravinahp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"surf-mcp-ravinahp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"surf-mcp-ravinahp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"surf-mcp-ravinahp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"surf-mcp-ravinahp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"surf-mcp-ravinahp": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-surf-mcp-ravinahp"
]
}
}
}FAQ
How do I get my Storm Glass API key?
Visit Storm Glass, create an account, and you will receive your API key.
Is there a free version of the API?
Yes, the free tier allows for 10 requests per day, with paid plans available for higher usage.
What programming language is required?
The server is built using Python 3.x.