MCP-Server

ski-france.com Agent Search

com.ski-france/agent-search
Reisen & Hospitality Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Searches French ski apartments with prices and availability and provides information on ski areas, resorts, accommodations, and ski-pass prices.

get_accommodation_detail
Get accommodation detail
Return accommodation-level context, apartment list, images, detail information and weekly availability for one public accommodation. Use this after search results to inspect all apartments belonging to one accommodation and to explain location, descriptions and detail notes. For price and bookability comparison for a specific week, prefer search_apartments with weekId.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['accommodationId'], 'properties': {'accommodationId': {'type': 'integer', 'minimum': 1, 'description': 'Accommodation id from search results or list_accommodations.'}}}
get_search_options
Get search options
Return the current structured search vocabulary before building a search: arrival weeks, one- or two-week durations, amenities, advanced apartment filters, price sorting, entity types and supported language subdomains. Use this first when you need valid parameter values.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
get_ski_area_detail
Get ski area detail
Return public ski area information, facts, images, ski maps and related ski resorts. Use this for destination context and recommendations, not for apartment prices or availability; use search_apartments for live week-specific accommodation results.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['skiAreaId'], 'properties': {'skiAreaId': {'type': 'integer', 'minimum': 1, 'description': 'Ski area id from list_ski_areas.'}}}
get_ski_pass_prices
Get ski pass prices
Return ski pass weeks, durations and price tables with listPrice, discount and discountedPrice. Restrict by skiAreaId, skiResortId or accommodationId for destination-specific ski pass discovery. A global request without destination scope must provide weekId to avoid an overly broad price matrix. Omit durationDays to discover available durations with prices.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Result page, starting at 1.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Results per page. Maximum is 50.'}, 'weekId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional fixed weekly winter arrival date id. Required when no skiAreaId, skiResortId or accommodationId is provided. Omit it only for destination-scoped ski pass discovery.'}, 'skiAreaId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski area id from list_ski_areas.'}, 'skiResortId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski resort id from list_ski_resorts.'}, 'durationDays': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski pass duration in days. Omit it to return all available durations with prices. Default website duration is 6 days.'}, 'accommodationId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional accommodation id from search_apartments, list_accommodations or get_accommodation_detail. Uses the accommodation ski resort.'}}}
get_ski_resort_detail
Get ski resort detail
Return public ski resort information, location, facts, images and ski maps. Use this for explaining and comparing destinations, not for apartment prices or availability; use search_apartments for live week-specific accommodation results.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['skiResortId'], 'properties': {'skiResortId': {'type': 'integer', 'minimum': 1, 'description': 'Ski resort id from list_ski_resorts.'}}}
list_accommodations
List accommodations
List public accommodations for catalogue discovery, optionally filtered by ski area, ski resort or district ids from the destination tools. This list intentionally has no prices, availability or bookability. Use search_apartments with weekId for price and availability comparison, and get_accommodation_detail after a result for accommodation context.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Result page, starting at 1.'}, 'limit': {'type': 'integer', 'default': 100, 'maximum': 200, 'minimum': 1, 'description': 'Results per page. Maximum is 200.'}, 'skiAreaId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski area id from list_ski_areas.'}, 'districtId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional district id from accommodation or search-scope data.'}, 'skiResortId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski resort id from list_ski_resorts.'}}}
list_ski_areas
List ski areas
List public ski areas in France for destination discovery and comparison. A ski area groups one or more ski resorts and can be used as a destination scope for apartment search. Parent regions only bundle ski areas and do not have a separate detail endpoint.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
list_ski_resorts
List ski resorts
List public ski resorts in France for destination discovery, optionally filtered by ski area id. A ski resort is the local destination or village/resort used for accommodation search scopes and resort detail pages.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'skiAreaId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional ski area id from list_ski_areas.'}}}
resolve_search_keywords
Resolve search keywords
Resolve a user phrase into concrete search-scope candidates such as parent regions, ski areas, ski resorts, districts or accommodations. Use the returned entityType and entityId in search_apartments when you want to restrict a later apartment search to a precise destination or accommodation. Broad searches can skip this and use keywords directly. Parent-region scopes are only for restricting searches, not for destination detail lookup.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Search phrase to resolve into possible destination or accommodation scopes, for example "Val Thorens", "3 Vallees" or an accommodation name.'}}}
search_apartments
Search ski apartments
Main apartment-level search for winter ski accommodation in French ski areas and ski resorts. Results are apartments, not whole accommodations. Put destination, ski area, ski resort or accommodation names into keywords. Use structured parameters for amenities, rooms, living space, slope distance, ski area size, parent areas, accommodation category, chalet type, pets and price sorting. Put the traveller count into partySize, not keywords. Use weekId and durationWeeks for one- or two-week price, availability, bookability and special-discount data.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Result page, starting at 1.'}, 'pets': {'enum': ['pets-allowed', 'pets-not-allowed'], 'type': 'string', 'default': None, 'description': 'Pet policy.'}, 'areas': {'type': 'array', 'items': {'enum': ['northern-alps', 'southern-alps', 'pyrenees', 'switzerland'], 'type': 'string'}, 'default': None, 'description': 'Parent-area values from get_search_options.', 'uniqueItems': True}, 'weekId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Fixed weekly winter arrival date id from get_search_options. Required for week-specific price, availability, bookabilityStatus and special-discount comparison.'}, 'entityId': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Optional precise search-scope entity id from resolve_search_keywords. Use together with entityType.'}, 'keywords': {'type': 'string', 'default': None, 'maxLength': 120, 'description': 'Natural-language destination or accommodation keywords, for example a ski resort, ski area, accommodation name or free text. Use the structured filter parameters for amenities and property requirements.'}, 'amenities': {'type': 'array', 'items': {'enum': ['sauna', 'whirlpool', 'steam-room', 'pool', 'chimney'], 'type': 'string'}, 'default': None, 'description': 'Amenity values from get_search_options.', 'uniqueItems': True}, 'partySize': {'type': 'integer', 'default': None, 'minimum': 1, 'description': 'Traveller count. Results are restricted to apartments whose capacity is at least this party size within the matching website occupancy bucket.'}, 'priceSort': {'enum': ['default', 'price-desc', 'price-asc'], 'type': 'string', 'default': 'default', 'description': 'Result sorting. Status remains the primary order, followed by price and party-size category.'}, 'entityType': {'enum': ['area', 'region', 'resort', 'district', 'accommodation'], 'type': 'string', 'default': None, 'description': 'Optional precise search-scope entity type from resolve_search_keywords. Use together with entityId to restrict results to a resolved parent region, ski area, ski resort, district or accommodation.'}, 'minBedrooms': {'enum': [1, 2, 3, 4, 5, 6, 7, 8], 'type': 'integer', 'default': None, 'description': 'Minimum number of bedrooms. Value 8 means 8 or more.'}, 'minBathrooms': {'enum': [1, 2, 3, 4, 5, 6, 7, 8], 'type': 'integer', 'default': None, 'description': 'Minimum number of bathrooms. Value 8 means 8 or more.'}, 'skiAreaSizes': {'type': 'array', 'items': {'enum': ['small', 'medium', 'large'], 'type': 'string'}, 'default': None, 'description': 'Ski-area size categories from get_search_options.', 'uniqueItems': True}, 'durationWeeks': {'enum': [1, 2], 'type': 'integer', 'default': 1, 'description': 'Stay duration in weeks. Two weeks requires weekId.'}, 'minSquareMeters': {'enum': [20, 30, 40, 60, 80, 100, 150, 200], 'type': 'integer', 'default': None, 'description': 'Minimum living space in square metres.'}, 'accommodationType': {'enum': ['chalet'], 'type': 'string', 'default': None, 'description': 'Optional accommodation type.'}, 'accommodationCategories': {'type': 'array', 'items': {'enum': ['premium', 'luxury'], 'type': 'string'}, 'default': None, 'description': 'Premium and luxury accommodation categories from get_search_options.', 'uniqueItems': True}, 'maxDistanceToSlopeMeters': {'enum': [100, 400], 'type': 'integer', 'default': None, 'description': 'Maximum distance to piste, lift or gondola in metres.'}}}
Hinzugefügt
get_ski_pass_prices
17. September 2026 12:37
Hinzugefügt
get_ski_resort_detail
17. September 2026 12:37
Hinzugefügt
list_ski_resorts
17. September 2026 12:37
Hinzugefügt
get_ski_area_detail
17. September 2026 12:37
Hinzugefügt
list_ski_areas
17. September 2026 12:37
Hinzugefügt
get_accommodation_detail
17. September 2026 12:37
Hinzugefügt
list_accommodations
17. September 2026 12:37
Hinzugefügt
resolve_search_keywords
17. September 2026 12:37
Hinzugefügt
get_search_options
17. September 2026 12:37
Hinzugefügt
search_apartments
17. September 2026 12:37