MCP 服务器

Villiers Charter

ai.villiers/charter
旅行与酒店 公开且可连接 MCP 2026-07-28

此 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.
只读 可访问外部资源 幂等
输入模式
{'type': 'object', 'required': ['trip_id'], 'properties': {'trip_id': {'type': 'string', 'description': 'The trip_id returned by request_jet_confirmation (REQUIRED)'}}}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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'}}}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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.'}}}
输出模式
{'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.
可能执行破坏性操作 可访问外部资源
输入模式
{'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'}}}
输出模式
{'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.
只读 可访问外部资源 幂等
输入模式
{'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.'}}}
输出模式
{'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'}}}
已添加
list_attributed_enquiries
2026年9月23日 02:51
已添加
search_empty_legs
2026年9月17日 07:57
已添加
get_confirmation_status
2026年9月17日 07:57
已添加
request_jet_confirmation
2026年9月17日 07:57
已添加
get_jet_estimate
2026年9月17日 07:57