Windscout

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

Tools

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