windscout-mcp
# 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
```bash
claude mcp add windforecast npx windscout-mcp
```
### Claude Desktop
Add to `~/.config/claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"windforecast": {
"command": "npx",
"args": ["windscout-mcp"]
}
}
}
```
### Other MCP clients
```bash
npx windscout-mcp
```
The server communicates over stdio using the [Model Context Protocol](https://modelcontextprotocol.io/).
## Data Sources
- **[Open-Meteo](https://open-meteo.com/)** -- Free weather API, no auth required. Used for forecast and marine data.
- **[Windfinder](https://www.windfinder.com/)** -- Wind and weather community. Used for spot search, live station data, and tides via HTML scraping.
## Development
```bash
npm install
npm test # run unit tests
npm run build # compile TypeScript
npm run dev # run with tsx (hot reload)
```
## License
MIT
TDQS
Scored across 5 tools
Each tool targets a distinct aspect: general forecast, live measurements, marine forecast, tides, and spot search. There is no overlap in functionality, and the descriptions clearly differentiate them.
All tools follow a consistent verb_noun pattern with snake_case: get_forecast, get_live_measurements, get_marine_forecast, get_tides, and search_spots. The only minor deviation is search instead of get, but it is a different action (search vs retrieve) and still fits the pattern.
With 5 tools, the server is well-scoped for a wind and weather information service. Each tool provides essential functionality without unnecessary bloat or gaps.
The set covers key use cases: spot search, real-time wind, hourly forecast, marine forecast, and tides. A minor gap is the lack of historical data or detailed spot metadata beyond coordinates, but the core workflows are supported.