avymcp

MCP server for avalanche forecasts, danger ratings, and field observations. Covers all 28 US avalanche centers via avalanche.org, Canadian regions via Avalanche Canada, and the Chic-Chocs (Gaspésie, Québec) via Avalanche Québec.

Deployed on Cloudflare Workers. No API keys required -- all upstream data sources are public.

Quick Start

A public demo instance is available for immediate use -- no setup or deployment needed:

https://avymcp.scottjohnbrereton-4c1.workers.dev/mcp

Claude Code

claude mcp add avymcp --transport http https://avymcp.scottjohnbrereton-4c1.workers.dev/mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "avymcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://avymcp.scottjohnbrereton-4c1.workers.dev/mcp"]
    }
  }
}

Cursor / Other MCP Clients

Point your client to the endpoint URL above using HTTP/Streamable transport.

Self-Hosting

You can also deploy your own instance -- see Development below.

Tools

get_forecast

Get a full avalanche forecast for a US zone. Returns danger ratings by elevation band, avalanche problems with aspect/elevation/likelihood/size, forecaster discussion, and bottom line summary.

Provide either zone (with optional center_id) or latitude/longitude.

Example prompts:

• "What's the avalanche forecast for Stevens Pass?"
• "Get me the forecast for the Bridger Range in Montana"
• "Avalanche conditions at 40.59, -111.64"

get_danger_ratings

Get current avalanche danger ratings. Returns the 1-5 danger level, travel advice, and active warnings.

With no arguments, returns danger ratings for all 82 US forecast zones. With center_id, returns just that center's zones. With lat/lon, returns the specific zone containing that point.

Example prompts:

• "What's the avalanche danger in Colorado right now?"
• "Show me danger ratings for all NWAC zones"
• "What was the danger level at Alta on March 15th?"

list_centers

List all 28 US avalanche centers and their forecast zones.

Example prompts:

• "What avalanche centers are there?"
• "Which centers cover Alaska?"
• "Find avalanche zones in Utah"

get_center_info

Get detailed information about a specific avalanche center.

Returns the center's website, contact info, timezone, list of forecast zones with IDs, and whether the center is in its off-season.

Example prompts:

• "Tell me about the Utah Avalanche Center"
• "What zones does GNFAC cover?"

get_observations

Get recent field observations from US avalanche centers. Includes trip reports, avalanche sightings, snowpack assessments, and weather observations.

Example prompts:

• "What are the recent observations from NWAC?"
• "Any avalanche observations in the last week?"
• "Show me field reports from Colorado this week"

get_observation_detail

Get full details of a single field observation by its UUID.

Returns the complete observation including weather conditions, snowpack assessment, avalanche details (type, trigger, size, aspect, elevation), and media links.

check_warnings

Check for active avalanche warnings and watches across all US centers. No parameters required.

Returns active warnings, zones at High (4) or Extreme (5) danger, and a summary of conditions nationwide.

Example prompts:

• "Are there any avalanche warnings right now?"
• "Where is the avalanche danger highest in the US?"

get_canada_forecast

Get an Avalanche Canada forecast by coordinates.

Returns danger ratings for 3 days across Alpine/Treeline/Below Treeline, avalanche problems, and forecaster summaries.

Example prompts:

• "What's the avalanche forecast near Whistler?"
• "Avalanche conditions at Rogers Pass, BC"

get_quebec_forecast

Get the current Avalanche Québec bulletin for the Chic-Chocs in Gaspésie. This region is NOT covered by the Avalanche Canada API, so it has its own tool. Covers Mont Albert, Mont Ernest-Laforce, Mont Hog's Back, Champs-de-Mars, Mont Lyall, Mont Vallières-de-Saint-Réal, Mont Blanche-Lamontagne, and Mines-Madeleine. Bulletins are issued daily December 1 – April 30.

Returns 3-day danger ratings across Alpine/Treeline/Below Treeline, avalanche problems (type, aspect, elevation, likelihood, size), travel advice, and avalanche/snowpack/weather summaries.

Example prompts:

• "What's the avalanche forecast for Mont Albert?"
• "Conditions in the Chic-Chocs today"
• "Get me the French bulletin for Gaspésie"

Data Sources

Danger Scale

Development

# Install dependencies
npm install

# Run locally
npm run dev

# Deploy to Cloudflare Workers
npm run deploy

Requires Wrangler CLI and a Cloudflare account.

Architecture

src/
├── index.ts                      # Entry point, health check, MCP handler
├── api/
│   ├── avalanche-org.ts          # US forecast API client
│   ├── observations.ts           # Observations API client
│   ├── avalanche-canada.ts       # Canada API client
│   └── avalanche-quebec.ts       # Avalanche Québec bulletin scraper
├── lib/
│   ├── html-to-text.ts           # HTML stripping for forecast text
│   ├── zone-resolver.ts          # Zone name resolution + point-in-polygon
│   └── types.ts                  # TypeScript type definitions
└── tools/
    ├── get-forecast.ts           # Full forecast retrieval
    ├── get-danger-ratings.ts     # Danger rating map/point lookup
    ├── list-centers.ts           # Center directory + search
    ├── get-center-info.ts        # Center detail
    ├── get-observations.ts       # Observation list + detail
    ├── check-warnings.ts         # Warning scanner
    ├── get-canada-forecast.ts    # Avalanche Canada forecasts
    └── get-quebec-forecast.ts    # Avalanche Québec (Chic-Chocs) forecast

License

MIT