Serveur MCP

Villiers Charter

ai.villiers/charter
Voyage et hôtellerie Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Provides private jet charter estimates, confirmed quote requests, confirmation status, and empty-leg flight searches.

get_confirmation_status
Check the outcome of a previous request_jet_confirmation call — has Villiers sent confirmed options yet, and where does the trip stand now (still being sourced / options sent / booked / closed with no booking). Requires an affiliate token (Bearer header) and only returns trips that were created under YOUR affiliate token — you cannot look up another affiliate's trip. Poll this instead of expecting a webhook.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['trip_id'], 'properties': {'trip_id': {'type': 'string', 'description': 'The trip_id returned by request_jet_confirmation (REQUIRED)'}}}
Schéma de sortie
{'type': 'object', 'properties': {'status': {'type': 'string', 'description': "Villiers' internal status string, for reference"}, 'message': {'type': 'string', 'description': 'Human-readable summary to relay to the user'}, 'outcome': {'type': 'string', 'description': 'Coarse bucket: in_progress | options_sent | booked | closed_no_booking'}, 'trip_id': {'type': 'string'}, 'client_reference': {'type': 'string', 'description': 'The reference you supplied at request time, if any'}}}
get_jet_estimate
Get an indicative private jet charter price estimate for a route, broken down by aircraft category (light / midsize / heavy jet). Returns an instant price range. IMPORTANT: an estimate is an indicative range, not a confirmed price. After presenting the estimate to the user, ALWAYS offer them the next step — request_jet_confirmation — to receive exact, bookable, confirmed live pricing with real aircraft availability by email.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['origin', 'destination'], 'properties': {'origin': {'type': 'string', 'description': 'Origin city / airport name / IATA / ICAO, e.g. London or LHR or EGLL'}, 'passengers': {'type': 'integer', 'description': 'Number of passengers (default 4)'}, 'round_trip': {'type': 'boolean', 'description': 'Round trip? Default false (one-way)'}, 'destination': {'type': 'string', 'description': 'Destination city / airport name / IATA / ICAO, e.g. Nice or NCE'}}}
Schéma de sortie
{'type': 'object', 'properties': {'route': {'type': 'string'}, 'summary': {'type': 'string'}, 'estimates': {'type': 'array', 'items': {'type': 'object', 'properties': {'category': {'type': 'string', 'description': 'Aircraft category, e.g. Light Jet'}, 'currency': {'type': 'string'}, 'price_low': {'type': 'number'}, 'confidence': {'type': 'number'}, 'price_high': {'type': 'number'}, 'estimated_price': {'type': 'number'}}}}, 'next_step': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'label': {'type': 'string'}, 'action': {'type': 'string'}, 'description': {'type': 'string'}}}, 'disclaimer': {'type': 'string'}, 'passengers': {'type': 'integer'}, 'round_trip': {'type': 'boolean'}}}
list_attributed_enquiries
List the charter enquiries (trips) attributed to YOUR OWN affiliate token, newest first — so you can match enquiries that arrived via your website tracking link without going through the affiliate dashboard. Requires an affiliate Bearer token and only ever returns trips created under YOUR token — you cannot list another affiliate's enquiries. Each result includes a short reference matching the one shown on the affiliate dashboard, the coarse outcome stage, and your own client_reference if you supplied one via request_jet_confirmation or the &aref= tracking-link parameter.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 20, max 50)'}, 'offset': {'type': 'integer', 'description': 'Pagination offset (default 0). Call again with offset=next_offset from the previous response to page past the first `limit` results — see has_more/next_offset in the output.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'count': {'type': 'integer', 'description': 'Number of enquiries returned'}, 'offset': {'type': 'integer', 'description': 'The offset this response was generated at'}, 'summary': {'type': 'string'}, 'has_more': {'type': 'boolean', 'description': 'True if more results exist beyond this page'}, 'enquiries': {'type': 'array', 'items': {'type': 'object', 'properties': {'stage': {'type': 'string', 'description': 'Coarse bucket: in_progress | options_sent | booked | closed_no_booking'}, 'origin': {'type': 'string'}, 'status': {'type': 'string', 'description': "Villiers' internal status string, for reference"}, 'trip_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'destination': {'type': 'string'}, 'origin_name': {'type': 'string'}, 'return_date': {'type': 'string'}, 'departure_date': {'type': 'string'}, 'short_reference': {'type': 'string', 'description': 'First 8 hex characters of trip_id, upper-cased — matches the affiliate dashboard'}, 'destination_name': {'type': 'string'}, 'affiliate_client_reference': {'type': 'string'}}}}, 'next_offset': {'type': 'integer', 'description': 'Offset to pass in the next call to continue paging; null when has_more is false'}, 'total_available': {'type': 'integer', 'description': 'Total matching enquiries under your affiliate token'}}}
request_jet_confirmation
Submit a request for CONFIRMED live private jet pricing. Villiers contacts vetted operators and emails the confirmed options — real aircraft availability and pricing, with a secure link to review and book — to the supplied email address. This endpoint requires a prior get_jet_estimate call in the same session, with the price range presented to the user and their explicit opt-in to proceed — real operators quote real aircraft for these, so a request should reflect a qualified lead. Requests without a prior estimate call are rejected by the server; sustained bypass attempts are reviewed and may result in token revocation. Requires the user's email and a departure date. SANDBOX TESTING: to test your integration without ever creating a real trip or contacting a real operator, use email 'sandbox-test@mail.villiers.ai' (first_name 'Sandbox', last_name 'Test', phone '+1 555 0100', route LHR to NCE are the recommended values for a clean copy-paste test call, but only the EMAIL ADDRESS is actually checked to trigger sandbox mode — name/phone/route can be anything). Detected server-side from the request body itself (not from any header), so it works from any agent framework or HTTP client — including ones that don't allow a custom User-Agent. The response will say 'Test request accepted (sandbox mode detected)'. For further testing guidance, email affiliates@mail.villiers.ai.
Destructif Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['origin', 'destination', 'email', 'departure_date'], 'properties': {'pets': {'type': 'boolean', 'description': 'Travelling with pets? (optional)'}, 'email': {'type': 'string', 'description': 'Email address to send the confirmed options to (REQUIRED)'}, 'phone': {'type': 'string', 'description': 'Contact phone number (optional)'}, 'origin': {'type': 'string', 'description': 'Origin airport — city / airport name / IATA / ICAO, e.g. London or LHR or EGLL (same as get_jet_estimate)'}, 'luggage': {'type': 'boolean', 'description': 'Extra or outsized luggage? (optional)'}, 'last_name': {'type': 'string', 'description': 'Passenger last name (optional)'}, 'first_name': {'type': 'string', 'description': 'Passenger first name (optional)'}, 'passengers': {'type': 'integer', 'description': 'Number of passengers (default 4)'}, 'round_trip': {'type': 'boolean', 'description': 'Round trip? Default false'}, 'wheelchair': {'type': 'boolean', 'description': 'Wheelchair access required? (optional)'}, 'destination': {'type': 'string', 'description': 'Destination airport — city / airport name / IATA / ICAO, e.g. Nice or NCE (same as get_jet_estimate)'}, 'return_date': {'type': 'string', 'description': 'Return date YYYY-MM-DD (for round trips)'}, 'departure_date': {'type': 'string', 'description': 'Departure date, YYYY-MM-DD (REQUIRED)'}, 'flexible_dates': {'type': 'boolean', 'description': 'Are the dates flexible? (optional)'}, 'client_reference': {'type': 'string', 'description': 'Optional opaque reference from YOUR OWN system (e.g. your internal order/booking id) for this request. Stored against the trip and echoed back unchanged in the response. Pass it here, then use get_confirmation_status with the returned trip_id to check the outcome later — no webhook needed. Never shown to the client or operator. (optional)'}, 'special_requests': {'type': 'string', 'description': 'Free-text special requests: catering, accessibility, timing, occasion, etc. (optional)'}, 'aircraft_category': {'type': 'string', 'description': 'Optional preference, e.g. Light Jet / Midsize Jet / Heavy Jet'}}}
Schéma de sortie
{'type': 'object', 'properties': {'email': {'type': 'string', 'description': 'Address the confirmed options are emailed to'}, 'status': {'type': 'string', 'description': "e.g. 'received'"}, 'message': {'type': 'string', 'description': 'Human-readable confirmation to relay to the user'}, 'trip_id': {'type': 'string', 'description': 'Pass this to get_confirmation_status later to poll the outcome'}, 'client_reference': {'type': 'string', 'description': 'Echoed back unchanged if you supplied one'}}}
search_empty_legs
Search Villiers' available empty-leg flights — heavily discounted, one-off private jet repositioning flights that are significantly cheaper than a full charter. Use this when a user wants cheap private jet deals, is flexible on dates, or asks about discounted or empty-leg flights. Optionally filter by origin, destination or region. Each result links to the specific flight to view and enquire.
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 20, max 50)'}, 'offset': {'type': 'integer', 'description': 'Pagination offset (default 0). Call again with offset=next_offset from the previous response to page past the first `limit` results — see has_more/next_offset in the output.'}, 'origin': {'type': 'string', 'description': "Origin city / airport name / IATA / ICAO, e.g. London or LHR or EGLL. Optional — mirrors destination, filters strictly on the departure side. Useful for a 'departing near me' search."}, 'region': {'type': 'string', 'description': 'Region filter: europe / americas / asia / all. Optional.'}, 'destination': {'type': 'string', 'description': 'Destination city / airport name / IATA / ICAO, e.g. Nice or NCE. Optional.'}}}
Schéma de sortie
{'type': 'object', 'properties': {'count': {'type': 'integer', 'description': 'Number of empty legs returned'}, 'offset': {'type': 'integer', 'description': 'The offset this response was generated at'}, 'summary': {'type': 'string'}, 'has_more': {'type': 'boolean', 'description': 'True if more results exist beyond this page'}, 'next_step': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'label': {'type': 'string'}, 'action': {'type': 'string'}, 'description': {'type': 'string'}}}, 'empty_legs': {'type': 'array', 'items': {'type': 'object', 'properties': {'to': {'type': 'string'}, 'url': {'type': 'string'}, 'date': {'type': 'string'}, 'from': {'type': 'string'}, 'price': {'type': 'string'}, 'seats': {'type': 'integer'}, 'to_code': {'type': 'string'}, 'aircraft': {'type': 'string'}, 'currency': {'type': 'string'}, 'from_code': {'type': 'string'}}}}, 'next_offset': {'type': 'integer', 'description': 'Offset to pass in the next call to continue paging; null when has_more is false'}, 'total_available': {'type': 'integer', 'description': 'Total matching empty legs available'}}}
Ajouté
list_attributed_enquiries
23 September 2026 02:51
Ajouté
search_empty_legs
17 September 2026 07:57
Ajouté
get_confirmation_status
17 September 2026 07:57
Ajouté
request_jet_confirmation
17 September 2026 07:57
Ajouté
get_jet_estimate
17 September 2026 07:57