Surf Forecast
Python-based MCP server that integrates the Open-Meteo Marine API to deliver global surf and marine forecasts. Converts any city name into geographic coordinates and provides swell height, period, direction, and wind conditions for surf spots worldwi
What is Surf Forecast?
Surf Forecast is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to python-based mcp server that integrates the open-meteo marine api to deliver global surf and marine forecasts. converts any city name into geographic coordinates and provides swell height, period, dir...
Python-based MCP server that integrates the Open-Meteo Marine API to deliver global surf and marine forecasts. Converts any city name into geographic coordinates and provides swell height, period, direction, and wind conditions for surf spots worldwi
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Python-based MCP server that integrates the Open-Meteo Marin
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-surf-forecastConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Surf Forecast
The Surf Forecast MCP server integrates the Open-Meteo Marine API to deliver real-time and extended surf forecasts for any location worldwide. It converts city or beach names into geographic coordinates and returns swell height, period, direction, wind speed, gusts, and multi-day outlooks. Surfers, coaches, and travel planners can ask their AI assistant for live conditions and surf quality assessments without leaving their workflow.
Prerequisites
- Python 3.9 or higher installed
- Git to clone the repository
- pip to install Python dependencies
- An MCP client such as Claude Desktop or Claude Code
Clone the repository
Download the mcp-surf-forecast source code from GitHub to your local machine.
git clone https://github.com/lucasinocencio1/mcp-surf-forecast.git
cd mcp-surf-forecastInstall Python dependencies
Install all required packages listed in requirements.txt, which includes the MCP SDK and the Open-Meteo client library.
pip install -r requirements.txtVerify the server runs
Run the MCP server directly to confirm it starts without errors before wiring it into a client.
python server.pyAdd the server to your MCP client config
Configure your MCP client (e.g., Claude Desktop) to launch the surf forecast server by pointing to the server.py file you cloned.
Test with a surf spot query
Ask your AI assistant for surf conditions at a known break. The server resolves city names to coordinates automatically and returns current and forecasted marine data.
Surf Forecast Examples
Client configuration
Add this block to your claude_desktop_config.json, replacing the path with the actual location of server.py on your system.
{
"mcpServers": {
"surf-forecast": {
"command": "python",
"args": ["/absolute/path/to/mcp-surf-forecast/server.py"]
}
}
}Prompts to try
Natural language prompts that exercise the server's marine forecasting capabilities.
- "What are the surf conditions at Monte de Caparica, Portugal right now?"
- "Give me a 5-day swell forecast for Pipeline, Hawaii"
- "Are conditions good for beginners at Byron Bay this weekend?"
- "What is the wind speed and direction at Hossegor, France today?"Troubleshooting Surf Forecast
ModuleNotFoundError when starting server.py
Ensure you ran 'pip install -r requirements.txt' from inside the cloned repository directory and that you are using the same Python interpreter that has the packages installed.
City name returns no coordinates or an error
Use a well-known city name or include the country (e.g., 'Nazare, Portugal'). Very small or misspelled place names may not resolve through the geocoding step.
Server not found in MCP client after configuration
Double-check that the args path in claude_desktop_config.json points to the absolute path of server.py, not a relative path, and restart the MCP client after saving the config.
Frequently Asked Questions about Surf Forecast
What is Surf Forecast?
Surf Forecast is a Model Context Protocol (MCP) server that python-based mcp server that integrates the open-meteo marine api to deliver global surf and marine forecasts. converts any city name into geographic coordinates and provides swell height, period, direction, and wind conditions for surf spots worldwi It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Surf Forecast?
Follow the installation instructions on the Surf Forecast GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Surf Forecast?
Surf Forecast works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Surf Forecast free to use?
Yes, Surf Forecast is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Surf Forecast Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Surf Forecast? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Surf Forecast in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Surf Forecast?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.