windscout-mcp

MCP server for wind forecasts, live measurements, wave forecasts, and tides. Built for kite and surf spot checks via AI assistants.

Tools

| Tool | Source | Description | |------|--------|-------------| | search_spots | Windfinder | Find spots by name or slug | | get_live_measurements | Windfinder | Real-time wind from weather stations | | get_forecast | Open-Meteo | Hourly wind + weather forecast (up to 16 days) | | get_marine_forecast | Open-Meteo | Wave height, period, and direction (up to 7 days) | | get_tides | Windfinder | High/low tide times and heights for coastal spots |

All wind speeds are returned in kn, km/h, and m/s.

Usage

Claude Code

claude mcp add windforecast npx windscout-mcp

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "windforecast": {
      "command": "npx",
      "args": ["windscout-mcp"]
    }
  }
}

Other MCP clients

npx windscout-mcp

The server communicates over stdio using the Model Context Protocol.

Data Sources

• Open-Meteo -- Free weather API, no auth required. Used for forecast and marine data.
• Windfinder -- Wind and weather community. Used for spot search, live station data, and tides via HTML scraping.

Development

npm install
npm test          # run unit tests
npm run build     # compile TypeScript
npm run dev       # run with tsx (hot reload)

License

MIT