Skip to main content
Glama
windscout-mcp

windscout-mcp

by jwillert

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.

Related MCP server: Surf Forecast MCP

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

Available Tools

5 tools
get_forecastA

Get hourly wind and weather forecast for up to 16 days. Uses Open-Meteo. Wind speed provided in kn, km/h, and m/s.

Inputs: lat (required), lon (required), days.

get_live_measurementsA

Get current real-time wind measurements from a Windfinder weather station. Requires spotId from search_spots.

Inputs: spotId (required).

get_marine_forecastA

Get hourly wave and swell forecast for up to 7 days. Uses Open-Meteo Marine API. Includes wave height (m), period (s), and direction.

Inputs: lat (required), lon (required), days.

get_tidesA

Get high/low tide times and heights for a coastal Windfinder spot. Requires spotId from search_spots. Returns empty for inland spots.

Inputs: spotId (required), days.

search_spotsA

Search for a wind spot by Windfinder slug or name. Returns spot info including coordinates. Call this first to get lat/lon and spotId for other tools.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers