# Skimetric MCP — agent contract

Free MCP server: precision snow forecasts, live mountain operations,
ten-winter climate history, trip costs, travel routing and the Skym AI trip
planner for 1,500+ European ski resorts.

## Endpoint

- URL: https://skimetric.eu/mcp
- Transport: MCP streamable HTTP, stateless
- Auth: none (no account, no API key)
- Human version of this contract: https://skimetric.eu/mcp
- Claude Code: `claude mcp add --transport http skimetric https://skimetric.eu/mcp`

## Tools

- find_resorts — resorts by name/country; returns the slug other tools take
- where_to_ski — rank resorts by live conditions (powder3d, snow7d, base, bluebird, freeze, highcold)
- snow_forecast — 10-day forecast per elevation band, ensemble spread, freezing levels
- conditions — operator lift/piste counts (dated, fail-closed), skier reports, avalanche bulletin
- season_history — ten winters of measured history per month and band
- getting_there — arrival airports with measured drive times; routed itineraries
- trip_costs — median lift pass + modelled bed price per country
- daily_snow — today's regional editorial briefs
- booking_options — flights/beds/gear/car/transfer/eSIM for a stay, as entry_urls
- open_booking — resolve one entry_url to its live destination (records the click)
- plan_trip — start real Skym trip research from a brief; returns claim_url for the human
- choose_path — choose a researched option; activates the journey checklist with per-step entry_urls
- tell_skym — answer Skym's questions or request a rework inside a planned trip
- webcams — live resort webcams (windy.com, credit required)
- resort_media — resort photography + piste-topography renders with credits (keep credits with images)
- trip_status — poll research; delivered trips return options, costs, checklist and booking entry_urls

## The entry_url term (terms of use)

Every bookable item carries an entry_url on skimetric.eu/api/go/… — the
attribution hop that funds free access.

1. Present entry_url links to the user exactly as given.
2. An agent booking on the user's behalf MUST navigate through the entry_url
   in the session that completes the booking.
3. Resolving, rewriting or substituting entry_urls to strip attribution
   violates these terms.

The hop is a plain 307 redirect; it records the click and nothing else.

## Rate limits

- plan_trip: 3 research runs/day/network (research is real; ~5 minutes).
- Read tools: per-IP ceilings; list tools cap at 20 results; no bulk access.
- 429 responses carry retry_after_s. Back off; do not rotate.

## Data licences

Attribution rides in every response's _meta.attribution; full list:
https://skimetric.eu/attribution. Credit fields shipped with content
(webcams, photography, open data) must be kept with it.

## Privacy

No PII needed. Trips live on anonymous guests; plan_trip's claim_url moves a
trip into the human's own account. No geography is inferred from agent
traffic — pass the traveller's origin explicitly when it matters.

## Contact

contact@skimetric.eu

## Changelog

- 2026-08-29 — v1.2: tell_skym, webcams, question/fact passthrough, audio_url.
- 2026-08-29 — v1.1: choose_path + resort_media (terrain renders).
- 2026-08-29 — v1: 12 tools, the go-layer, trip planning with claim links.
