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.

Parameter	Type	Required	Description
zone	string	no	Zone name (e.g. "Stevens Pass", "Salt Lake", "Bridger Range")
center_id	string	no	Center ID to narrow search (e.g. "NWAC", "UAC", "CAIC")
latitude	number	no	Latitude for point-based lookup
longitude	number	no	Longitude for point-based lookup

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.

Parameter	Type	Required	Description
center_id	string	no	Filter by center (e.g. "NWAC", "UAC", "CAIC")
latitude	number	no	Latitude for point lookup
longitude	number	no	Longitude for point lookup
date	string	no	Historical date (YYYY-MM-DD)

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.

Parameter	Type	Required	Description
search	string	no	Search by center name, zone name, or state (e.g. "CO", "Montana", "NWAC")

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.

Parameter	Type	Required	Description
center_id	string	yes	Center ID (e.g. "NWAC", "UAC", "CAIC", "GNFAC")

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.

Parameter	Type	Required	Description
center_id	string	no	Filter by center (e.g. "NWAC", "UAC")
days_back	number	no	Days to look back (default: 3, max: 14)
page_size	number	no	Number of results (default: 10, max: 25)

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.

Parameter	Type	Required	Description
observation_id	string	yes	Observation UUID (from get_observations results)

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.

Parameter	Type	Required	Description
latitude	number	yes	Latitude (e.g. 51.3 for Rogers Pass)
longitude	number	yes	Longitude (e.g. -117.5 for Rogers Pass)
language	string	no	"en" (default) or "fr"

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.

Parameter	Type	Required	Description
language	string	no	"en" (default) or "fr"
latitude	number	no	Optional lat for a sanity check that the point is in the Chic-Chocs
longitude	number	no	Optional lon for a sanity check that the point is in the Chic-Chocs

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

Source	Coverage	Auth
Avalanche.org API	28 US centers, 82 zones	None
Avalanche.org Observations API	Field reports from all US centers	Referer header
Avalanche Canada API	All Canadian forecast regions	None
Avalanche Québec	Chic-Chocs, Gaspésie, Québec	None (HTML scrape)

Danger Scale

Level	Rating	Color
1	Low	Green
2	Moderate	Yellow
3	Considerable	Orange
4	High	Red
5	Extreme	Black

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