Skip to main content
Glama

Villiers Charter

Server Details

Instant private jet charter price estimates and confirmed live quotes, worldwide.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Available Tools

4 tools
get_confirmation_statusA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
trip_idYesThe trip_id returned by request_jet_confirmation (REQUIRED)

Output Schema

ParametersJSON Schema
NameRequiredDescription
statusNoVilliers' internal status string, for reference
messageNoHuman-readable summary to relay to the user
outcomeNoCoarse bucket: in_progress | options_sent | booked | closed_no_booking
trip_idNo
client_referenceNoThe reference you supplied at request time, if any

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond annotations (readOnlyHint, idempotentHint), the description adds critical behavioral details: requires Bearer header, scoped to own affiliate token, and intended for polling. No contradictions with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no redundant words, front-loaded with purpose. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple tool (one param, read-only, with output schema), the description covers all needed context: purpose, usage, auth, scope, and polling recommendation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter with 100% schema coverage; schema description already explains it's the trip_id from request_jet_confirmation. Description adds no further semantic value, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it checks the outcome of a previous request_jet_confirmation call, specifying what it checks (confirmed options, trip status) and distinguishing itself from sibling tools like get_jet_estimate or request_jet_confirmation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly tells when to use (polling instead of webhook), prerequisites (requires affiliate token), and limitations (only returns trips under your token, cannot look up others).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_jet_estimateA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
originYesOrigin city / airport name / IATA / ICAO, e.g. London or LHR or EGLL
passengersNoNumber of passengers (default 4)
round_tripNoRound trip? Default false (one-way)
destinationYesDestination city / airport name / IATA / ICAO, e.g. Nice or NCE

Output Schema

ParametersJSON Schema
NameRequiredDescription
routeNo
summaryNo
estimatesNo
next_stepNo
disclaimerNo
passengersNo
round_tripNo

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false. Description adds that it's an indicative range, not confirmed, and breaks down by category. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with purpose, then usage guidance. No redundant words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Output schema exists (though not shown) and description explains return type and next steps. Complete for a read-only estimation tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with parameter descriptions. Description doesn't detail each parameter but provides context on route and aircraft categories. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it provides an indicative private jet charter price estimate for a route, broken down by aircraft category. Distinguishes itself from siblings by focusing on estimates.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly instructs to present estimate and then offer next step (request_jet_confirmation). Lacks explicit when-not-to-use but provides clear sequential guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

request_jet_confirmationA
Destructive
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
petsNoTravelling with pets? (optional)
emailYesEmail address to send the confirmed options to (REQUIRED)
phoneNoContact phone number (optional)
originYesOrigin airport — city / airport name / IATA / ICAO, e.g. London or LHR or EGLL (same as get_jet_estimate)
luggageNoExtra or outsized luggage? (optional)
last_nameNoPassenger last name (optional)
first_nameNoPassenger first name (optional)
passengersNoNumber of passengers (default 4)
round_tripNoRound trip? Default false
wheelchairNoWheelchair access required? (optional)
destinationYesDestination airport — city / airport name / IATA / ICAO, e.g. Nice or NCE (same as get_jet_estimate)
return_dateNoReturn date YYYY-MM-DD (for round trips)
departure_dateYesDeparture date, YYYY-MM-DD (REQUIRED)
flexible_datesNoAre the dates flexible? (optional)
client_referenceNoOptional 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_requestsNoFree-text special requests: catering, accessibility, timing, occasion, etc. (optional)
aircraft_categoryNoOptional preference, e.g. Light Jet / Midsize Jet / Heavy Jet

Output Schema

ParametersJSON Schema
NameRequiredDescription
emailNoAddress the confirmed options are emailed to
statusNoe.g. 'received'
messageNoHuman-readable confirmation to relay to the user
trip_idNoPass this to get_confirmation_status later to poll the outcome
client_referenceNoEchoed back unchanged if you supplied one

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already indicate destructiveHint=true, but the description adds important context: it contacts real operators, sends emails to the user, requires a qualified lead, enforces the prior estimate call with server-side rejection, and may revoke tokens for bypass attempts. Sandbox mode behavior is also disclosed, adding significant value beyond annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is longer than average but well-structured: it front-loads the purpose, then clarifies prerequisites, provides sandbox testing details, and closes with support contact. Every sentence serves a purpose, though the sandbox section is lengthy and slightly repetitive about the prior estimate requirement.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a complex tool with real-world side effects and 17 parameters, yet the description covers prerequisites, consequences, sandbox mode, and support contact. The output schema exists, so return values need not be described. It is complete enough for an agent to use correctly, including handling of errors and testing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with descriptions for all 17 parameters, so the baseline is 3. The description adds minimal parameter-specific detail—it correctly highlights email and departure date as essential, and explains the sandbox email trigger. However, it omits origin and destination as required (though the schema lists them), so it does not fully compensate. Overall, schema carries the load.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Submit a request for CONFIRMED live private jet pricing.' It clearly distinguishes itself from the sibling get_jet_estimate by requiring a prior estimate call and from get_confirmation_status by describing the submission of the request rather than status checking.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states that a prior get_jet_estimate call is required and that requests without one are rejected. It also provides sandbox testing instructions with a specific email to avoid real-world impact, and directs further questions to an email. This gives clear when-to-use and when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_empty_legsA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax results (default 20, max 50)
originNoOrigin 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.
regionNoRegion filter: europe / americas / asia / all. Optional.
destinationNoDestination city / airport name / IATA / ICAO, e.g. Nice or NCE. Optional.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countNoNumber of empty legs returned
summaryNo
next_stepNo
empty_legsNo
total_availableNoTotal matching empty legs available

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only, idempotent, non-destructive, so the description isn't burdened with safety disclosure. It adds that results link to specific flights for viewing and enquiry, which is useful behavioral context about how to proceed after results. No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences with front-loaded purpose, explicit usage trigger, and result behavior. No fluff or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a search tool with full schema coverage and an output schema, the description covers the purpose, usage context, filter options, and post-result behavior. Nothing essential is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers all four parameters with descriptions, matching the description's mention of origin, destination, and region filters. The description adds no new semantics beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Search Villiers' available empty-leg flights') with context on what empty-leg flights are. Clearly distinguishes from sibling tools by being the search/listing tool while siblings handle status, estimates, and requests.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit when-to-use guidance: 'when a user wants cheap private jet deals, is flexible on dates, or asks about discounted or empty-leg flights.' Doesn't explicitly name alternatives, but sibling tools are distinct, and the description implies this is the search entry point. Could have added exclusions, but adequate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Give AI agents the ability to search private jets, compare aircraft, get quotes, and submit charter requests through natural language.
    7
    13
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI clients to search discounted private-jet empty-leg flights, retrieve flight details, obtain booking links, estimate charter prices, and submit charter enquiries.
  • A
    license
    Not graded
    quality
    B
    maintenance
    Book hotels worldwide — search, price, prebook & book across 249 countries. 65 tools for hotel search, flights, loyalty, analytics. Zero API keys needed. at best prices for hotels 3 M+ property
    22
    1
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.5/5.0
Disambiguation5/5

Each tool serves a distinct, clearly defined purpose: estimates, confirmed pricing requests, status checks, and empty-leg searches. There is no overlap or ambiguity between tool functions.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern in snake_case (get_, request_, search_), making it easy to predict tool behavior from the name alone.

Tool Count5/5

Four tools precisely cover the core capabilities needed for a private jet charter assistant: estimation, confirmation, status tracking, and empty-leg deals. No tool feels redundant or missing.

Completeness4/5

The set covers the primary workflow (estimate → request confirmation → check status) and adds empty-leg search. However, the actual booking is handled externally via email, and there is no tool to modify or cancel requests.

Resources