Windscout

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