# ski-france.com

Search about 9,000 ski apartments with structured amenities and advanced filters, one- or two-week prices, specials and availability, plus destinations and ski passes through the ski-france.com Agent API and MCP server.

Agents can compare accommodation, ski area and ski resort information, advanced apartment requirements, effective stay prices, availability, bookability, accommodation details and ski pass prices for the winter season.

## Preferred Agent Entry Point

- OpenAPI: https://en.ski-france.com/api/agent/v1/openapi.yaml
- Swagger UI: https://en.ski-france.com/api/agent/v1/docs/
- Capability Card: https://en.ski-france.com/.well-known/capability-card.json
- Agent MCP Server: https://en.ski-france.com/api/agent/v1/mcp/
- Use OpenAPI or Swagger UI for normal HTTP discovery.
- Use the read-only MCP server only when your client explicitly supports MCP tools over HTTP.
- Do not treat the MCP endpoint as a generic GET resource or human-readable documentation page.

## About ski-france.com

- Provider: ski-france.com, a specialist online travel provider for winter ski holidays in France.
- Specialization: bookable winter accommodation in French ski areas and ski resorts, especially chalets, holiday apartments and apartment-style residences, plus ski pass price data where available.
- Accommodation scope: apartment-level search results; about 9,000 distinct apartment-level units; one accommodation can contain one or more apartments.
- Ski passes: ski pass weeks, durations, list prices, discounts and discounted prices are available through the Agent Ski Pass Prices endpoint where ski pass data exists.
- Service/contact: agents should send users to the canonical website URLs for details, live availability, prices, service contact and booking.
- Languages: use the English website and English API entry points for international AI use. API language is selected by language subdomain; `/api/agent/v1/search-options/` lists supported languages and their API URLs.
- Target users: travelers, families and groups comparing and booking one- or two-week winter accommodation for fixed arrival dates in France's ski destinations.

## Primary English URLs

- Markdown link index: [English website](https://en.ski-france.com/), [English sitemap](https://en.ski-france.com/sitemaps/sitemap.en.xml.gz), [robots policy](https://ski-france.com/robots.txt), [full LLM context](https://en.ski-france.com/llms-full.txt), [agent instructions](https://en.ski-france.com/AGENTS.md), [OpenAPI](https://en.ski-france.com/api/agent/v1/openapi.yaml), [Swagger UI](https://en.ski-france.com/api/agent/v1/docs/), [capability card](https://en.ski-france.com/.well-known/capability-card.json), [Agent MCP server](https://en.ski-france.com/api/agent/v1/mcp/)
- English website: https://en.ski-france.com/
- English sitemap: https://en.ski-france.com/sitemaps/sitemap.en.xml.gz
- Robots policy: https://ski-france.com/robots.txt
- Full LLM context: https://en.ski-france.com/llms-full.txt
- Agent instructions: https://en.ski-france.com/AGENTS.md
- Agent Search API: https://en.ski-france.com/api/agent/v1/search/
- Agent Accommodation List: https://en.ski-france.com/api/agent/v1/accommodations/
- Agent Accommodation Detail: https://en.ski-france.com/api/agent/v1/accommodations/{id}/
- Agent Ski Area List: https://en.ski-france.com/api/agent/v1/ski-areas/
- Agent Ski Area Detail: https://en.ski-france.com/api/agent/v1/ski-areas/{id}/
- Agent Ski Resort List: https://en.ski-france.com/api/agent/v1/ski-resorts/
- Agent Ski Resort Detail: https://en.ski-france.com/api/agent/v1/ski-resorts/{id}/
- Agent Search Options: https://en.ski-france.com/api/agent/v1/search-options/
- Agent Search Scopes: https://en.ski-france.com/api/agent/v1/search-scopes/
- Agent Ski Pass Prices: https://en.ski-france.com/api/agent/v1/ski-passes/
- Agent MCP Server: https://en.ski-france.com/api/agent/v1/mcp/
- Agent Search OpenAPI: https://en.ski-france.com/api/agent/v1/openapi.yaml
- Agent Search Swagger UI: https://en.ski-france.com/api/agent/v1/docs/

## Agent guidance

- Use the English website and English sitemap as the primary entry points for international AI search.
- To change API language, use the corresponding language subdomain, for example `https://de.ski-france.com/`; do not pass a locale query parameter.
- Use the Agent Search API for structured apartment-level search results with amenities, advanced filters, one- or two-week prices, availability, bookability and special discount data.
- Use Agent Accommodation List only for catalogue discovery of accommodations in a ski area, resort or district; it does not contain prices or availability.
- Use Agent Accommodation Detail after a search result when accommodation-level context, apartment lists, images and full weekly availability are needed.
- Use Agent Ski Area List and Agent Ski Resort List to discover available destinations. Use Agent Ski Area Detail and Agent Ski Resort Detail for public destination information. Parent regions only bundle ski areas and do not have a separate detail endpoint.
- Use Agent Ski Pass Prices for ski pass weeks, durations, list prices, discounts and discounted prices.
- For global ski pass price queries, provide `weekId`; omit `weekId` only when restricting by ski area, ski resort or accommodation.
- Use OpenAPI and Swagger UI as the default discovery path for normal HTTP integrations.
- Use the Agent MCP Server only for clients that explicitly support MCP tools over HTTP.
- Use `keywords` as the default natural-language search path.
- Use Agent Search Scopes only when a query should be restricted to a specific parent region, ski area, ski resort, district or accommodation before calling the search API.
- Use `partySize` for the traveller count in agent searches.
- Use `amenities` and the dedicated advanced-search parameters instead of putting structured requirements into `keywords`.
- Set `durationWeeks=2` only together with `weekId`; use `priceSort` for price ordering within the primary status order.
- Public pages may be used to answer questions about ski accommodation, resorts, prices, availability and ski passes.
- Agents should send users to the canonical website URLs returned in search results and accommodation pages.