Serveur MCP

booking

com.beachvalencia/booking
Voyage et hôtellerie Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Searches holiday apartment availability, returns property details and quotes, and provides cancellation and stay policies.

get_policies
Get policies
Return the official policies of the property: check-in / check-out times, cancellation summary, refundable deposit rules, the mandatory Spanish traveller registration (SES.Hospedajes) and the contact email. Use it whenever the traveller asks about "cancellation", "deposit", "check-in time", "how does registration work", etc. Example: {"language":"en"}.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'language': {'enum': ['es', 'en'], 'type': 'string', 'description': 'Response language. Defaults to en.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['check_in', 'check_out', 'cancellation', 'deposit', 'online_check_in', 'contact'], 'properties': {'contact': {'type': 'string'}, 'deposit': {'type': 'string'}, 'check_in': {'type': 'string'}, 'check_out': {'type': 'string'}, 'cancellation': {'type': 'object', 'required': ['summary', 'details_url'], 'properties': {'summary': {'type': 'string'}, 'details_url': {'type': 'string'}}, 'additionalProperties': False}, 'online_check_in': {'type': 'string'}}, 'additionalProperties': False}
get_property_details
Get property details
Return description, capacity, amenities and photos for one property category (G1..G6 or G4B). Use it after search_availability when the traveller wants to compare or see more detail about a specific option. The exact apartment address and access instructions are shared by email only after the reservation is confirmed — never expose them here or invent them. Example: {"id":"G4","language":"en"}.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Property/type ID (G1..G6 or G4B).'}, 'language': {'enum': ['es', 'en'], 'type': 'string', 'description': 'Response language. Defaults to en.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'max_guests', 'bedrooms', 'size_sqm', 'location', 'highlights', 'description', 'amenities', 'photos', 'booking_url_base', 'priority_note', 'priority_url'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'bedrooms': {'type': 'string'}, 'location': {'type': 'string'}, 'size_sqm': {'type': ['number', 'null']}, 'amenities': {'type': 'object', 'required': ['parking', 'pool_seasonal'], 'properties': {'parking': {'type': 'boolean'}, 'pool_seasonal': {'type': 'boolean'}}, 'additionalProperties': False}, 'highlights': {'type': 'array', 'items': {'type': 'string'}}, 'max_guests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'description': {'type': 'string'}, 'priority_url': {'type': 'string'}, 'priority_note': {'type': 'string'}, 'booking_url_base': {'type': 'string'}}, 'additionalProperties': False}
get_quote
Get quote
Return the exact total EUR price for one property category and date range. The price matches what checkout charges a non-member with no discount code — if the traveller has a code, they enter it themselves on beachvalencia.com. Includes deposit and cancellation summary. If the dates are not available, "available" is false and booking_url points to the search page as a fallback. Example: {"id":"G4","check_in":"2027-06-08","check_out":"2027-06-15","adults":6}.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'check_in', 'check_out', 'adults'], 'properties': {'id': {'type': 'string', 'description': 'Property/type ID (G1..G6 or G4B).'}, 'adults': {'type': 'integer', 'maximum': 32, 'minimum': 1}, 'check_in': {'type': 'string', 'description': 'Arrival date YYYY-MM-DD.'}, 'children': {'type': 'array', 'items': {'type': 'integer', 'maximum': 17, 'minimum': 0}, 'maxItems': 10}, 'language': {'enum': ['es', 'en'], 'type': 'string'}, 'check_out': {'type': 'string', 'description': 'Departure date YYYY-MM-DD.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'currency', 'check_in', 'check_out', 'nights', 'guests', 'available', 'deposit', 'cancellation', 'cancellation_details_url', 'booking_url'], 'properties': {'id': {'type': 'string'}, 'hint': {'type': 'string'}, 'name': {'type': 'string'}, 'guests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'deposit': {'type': 'string'}, 'check_in': {'type': 'string'}, 'currency': {'type': 'string', 'const': 'EUR'}, 'available': {'type': 'boolean'}, 'check_out': {'type': 'string'}, 'booking_url': {'type': 'string'}, 'cancellation': {'type': 'string'}, 'discount_note': {'type': 'string'}, 'min_stay_nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'nightly_avg_eur': {'type': 'number'}, 'total_price_eur': {'type': 'number'}, 'public_price_eur': {'type': 'number'}, 'cancellation_details_url': {'type': 'string'}}, 'additionalProperties': False}
search_availability
Search availability
Search availability across every apartment category for a given date range and party size. Returns one match per available category with total EUR price (public rate, no discount code), photos and a booking_url that opens beachvalencia.com with dates and guests pre-filled. Use it whenever the traveller asks "what do you have from X to Y for N people". Example: {"check_in":"2027-05-22","check_out":"2027-05-27","adults":4}.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['check_in', 'check_out', 'adults'], 'properties': {'adults': {'type': 'integer', 'maximum': 32, 'minimum': 1, 'description': 'Number of adults.'}, 'check_in': {'type': 'string', 'description': 'Arrival date (YYYY-MM-DD, Europe/Madrid).'}, 'children': {'type': 'array', 'items': {'type': 'integer', 'maximum': 17, 'minimum': 0}, 'maxItems': 10, 'description': 'Optional list of children ages. Only the count is used to size the property.'}, 'language': {'enum': ['es', 'en'], 'type': 'string', 'description': 'Response language. Defaults to en if omitted or unsupported.'}, 'check_out': {'type': 'string', 'description': 'Departure date (YYYY-MM-DD, Europe/Madrid); must be strictly after check_in.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['currency', 'check_in', 'check_out', 'nights', 'guests', 'matches', 'minimum_stay_only', 'priority_note', 'priority_url'], 'properties': {'guests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'max_guests', 'bedrooms', 'location', 'highlights', 'total_price_eur', 'nightly_avg_eur', 'nights', 'photos', 'booking_url'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'bedrooms': {'type': 'string'}, 'location': {'type': 'string'}, 'highlights': {'type': 'array', 'items': {'type': 'string'}}, 'max_guests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'booking_url': {'type': 'string'}, 'discount_note': {'type': 'string'}, 'min_stay_nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'nightly_avg_eur': {'type': 'number'}, 'total_price_eur': {'type': 'number'}, 'public_price_eur': {'type': 'number'}}, 'additionalProperties': False}}, 'check_in': {'type': 'string'}, 'currency': {'type': 'string', 'const': 'EUR'}, 'check_out': {'type': 'string'}, 'priority_url': {'type': 'string'}, 'priority_note': {'type': 'string'}, 'minimum_stay_only': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'min_stay_nights'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'min_stay_nights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}, 'description': 'Properties that would be available if the stay met the minimum-nights rule.'}}, 'additionalProperties': False}
Ajouté
get_policies
2 October 2026 02:40
Ajouté
get_quote
2 October 2026 02:40
Ajouté
get_property_details
2 October 2026 02:40
Ajouté
search_availability
2 October 2026 02:40