AlpineConditions-MCP

An HTTP MCP server for alpineconditions.com weather and geolocation tools, designed for Cloudflare Workers.

• get_weather_forecast

  • Inputs: latitude, longitude, optional models
  • Loads forecast data from https://apigateway.alpineconditions.com/weatherforecastapi/weatherForecast
  • Returns structured forecast JSON with:
    • overviewByModel (high-level stats)
    • sixHourlyByModel (6-hour chunked summaries for easier LLM interpretation)
  • Includes compact model context for LLM use (used and concise selectedModelNotes)
  • Use get_weather_model_guidance for full location-wide model guidance details

• get_historical_weather_estimate

  • Inputs: latitude, longitude
  • Loads historical estimate data from https://apigateway.alpineconditions.com/weatherforecastapi/historicalestimate
  • Returns structured estimate JSON with:
    • overview (high-level stats for the recent historical window)
    • sixHourly (6-hour chunked summaries over the historical timeline)

• get_location_name_from_geolocation

  • Uses https://apigateway.alpineconditions.com/geolocation
  • Resolves a human-readable location via https://apigateway.alpineconditions.com/weatherforecastapi/location

• get_weather_model_guidance

  • Inputs: latitude, longitude
  • Returns location-specific model guidance, including:
    • whether Alpine Conditions Blend is available
    • which high-resolution models are available at that location
    • model-specific usage guidance

• get_avalanche_bulletin

  • Inputs: latitude, longitude
  • Loads avalanche bulletin data from https://apigateway.alpineconditions.com/avalancheapi
  • Internally resolves area ID by coordinates, then loads the latest area bulletin
  • Returns structured bulletin JSON including area metadata, danger ratings, problems, and terrain/travel advice

• https://mcp.alpineconditions.com/mcp
• MCP Inspector

npm install
npm run build

npm run dev

MCP endpoint: http://127.0.0.1:8787/mcp

npm run deploy

npm run build:mcpb

This creates alpineconditions.mcpb in the repository root for import into Claude Desktop.

npm run test:prod

This runs live integration tests against https://www.alpineconditions.com.

• ALPINECONDITIONS_BASE_URL (optional)
  • Default: https://apigateway.alpineconditions.com
  • Useful for local testing or alternate environments.
  • In Cloudflare Workers, set this as a Worker environment variable.

This server intentionally uses a self-contained API client under src/services and does not depend on frontend app modules from other repositories.