Skip to main content
Glama
Sign In
windscout-mcp

windscout-mcp

by jwillert
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    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
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches