custom_route_build

Break a complex multi-city itinerary into individually-ticketable segments with carrier recommendations. Handles routes that don't fit alliance fare rules — mixed carriers, LCCs, Gulf bridge connections, surface sectors. This is how AirTreks consultants build 90% of itineraries. Use this for any route with 4+ stops, backtracking, or region combinations that alliance fares can't cover.

read-only

Argument	Type	Description
pax	number	Number of passengers
budget	string	Budget tier: 'budget' prioritizes LCCs, 'business' prioritizes J-class product quality
cities*	array	Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'CMB', 'NBO', 'LIS', 'LAX'])
preferences	array	Preferences: 'no-lcc', 'lounge-access', 'short-layovers', 'surface-ok'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities"
  ],
  "properties": {
    "pax": {
      "type": "number",
      "description": "Number of passengers"
    },
    "budget": {
      "enum": [
        "budget",
        "mid",
        "premium",
        "business"
      ],
      "type": "string",
      "description": "Budget tier: 'budget' prioritizes LCCs, 'business' prioritizes J-class product quality"
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'CMB', 'NBO', 'LIS', 'LAX'])"
    },
    "preferences": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Preferences: 'no-lcc', 'lounge-access', 'short-layovers', 'surface-ok'"
    }
  }
}

fare_product_match

Recommend the best fare product type for a route — RTW, Circle Pacific, Circle Atlantic, Open Jaw, or Custom Multi-City. Considers stop count, direction, and backtracking to match the right alliance fare structure.

read-only

Argument	Type	Description
cities*	array	Ordered list of IATA city/airport codes
isOneDirection	boolean	Is the route traveling continuously in one direction (east or west)?
includeBacktracking	boolean	Does the route backtrack or zigzag between regions?

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities"
  ],
  "properties": {
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ordered list of IATA city/airport codes"
    },
    "isOneDirection": {
      "type": "boolean",
      "description": "Is the route traveling continuously in one direction (east or west)?"
    },
    "includeBacktracking": {
      "type": "boolean",
      "description": "Does the route backtrack or zigzag between regions?"
    }
  }
}

fare_quote

Get live, bookable-quality fares for one specific itinerary — actual flights, actual prices, for the dates given. Needs a departure date for every flown leg. Use this once the customer has settled on cities and dates and wants real numbers rather than a ballpark; use route_estimate instead when dates are still open. It prices the itinerary as a single fare, so very long or awkward multi-continent trips may come back unpriceable — those genuinely need to be split across separate tickets, which is what AirTreks consultants do by hand.

read-only

Argument	Type	Description
cabin	string	Cabin to price. Defaults to economy. 'premium' means premium economy.
dates*	array	Departure date for each FLOWN leg, in travel order, as YYYY-MM-DD. Overland legs marked with '000' do not take a date.
adults	integer	Adult travellers. Defaults to 1.
cities*	array	Ordered list of IATA city/airport codes, e.g. ['LAX','NRT','BKK']. Put '000' between two codes to mark that leg as travelled overland rather than flown.
infants	integer	Infants under 2.
children	integer	Children aged 2-11.
maxOptions

hub_check

Check the best connection between two airports. Identifies dead legs (routes that fail on alliance fares), suggests hub routing fixes, and shows proven carrier combinations. Essential for transpacific, kangaroo, and intra-Asia routing.

read-only

Argument	Type	Description
to*	string	Destination IATA airport code (e.g. 'JFK')
from*	string	Origin IATA airport code (e.g. 'SYD')
alliance	string	Preferred alliance: 'star' or 'oneworld'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Destination IATA airport code (e.g. 'JFK')"
    },
    "from": {
      "type": "string",
      "description": "Origin IATA airport code (e.g. 'SYD')"
    },
    "alliance": {
      "type": "string",
      "description": "Preferred alliance: 'star' or 'oneworld'"
    }
  }
}

itinerary_quote

Price a complete multi-stop or round-the-world trip and get back several ways of ticketing it — cheapest, fastest, fewest stops — with the actual tickets each one is built from. Use this for trips that will not go on a single fare, which is most itineraries with 3+ stops; use fare_quote when you want one specific itinerary on one ticket. It takes about a minute, so it returns a quoteReference immediately; call itinerary_quote_status with it straight away, and that call waits for the result. Keep that reference — it is the only way to retrieve the quote.

Argument	Type	Description
cabin	string	Cabin to price. Defaults to economy. 'premium' means premium economy.
dates*	array	Departure date for each FLOWN leg, in travel order, as YYYY-MM-DD.
adults	integer	Adult travellers. Defaults to 1.
cities*	array	Ordered list of IATA city/airport codes for the whole trip, e.g. ['LAX','NRT','BKK','LHR','LAX']. Put '000' between two codes to mark that leg as travelled overland rather than flown.
infants	integer	Infants under 2.
children	integer	Children aged 2-11.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities",
    "dates"
  ],
  "properties": {
    "cabin": {
      "enum": [
        "economy",
        "premium",
        "business",
        "first"
      ],
      "type": "string",
      "description": "Cabin to price. Defaults to economy. 'premium' means premium economy."
    },
    "dates": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Departure date for each FLOWN leg, in travel order, as YYYY-MM-DD."
    },
    "adults": {
      "type": "integer",
      "maximum": 9,
      "minimum": 1,
      "description": "Adult travellers. Defaults to 1."
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 12,
      "minItems": 2,
      "description": "Ordered list of IATA city/airport codes for the whole trip, e.g. ['LAX','NRT','BKK','LHR','LAX']. Put '000' between two codes to mark that leg as travelled overland rather than flown."
    },
    "infants": {
      "type": "integer",
      "maximum": 8,
      "minimum": 0,
      "description": "Infants under 2."
    },
    "children": {
      "type": "integer",
      "maximum": 8,
      "minimum": 0,
      "description": "Children aged 2-11."
    }
  }
}

itinerary_quote_status

Fetch the result of an itinerary_quote using the quoteReference it returned. Call it straight away: it waits up to about 40 seconds for a quote that is still pricing, then returns the finished options, or status 'pending' if the quote needs one more call. Costs nothing and does no searching, so call it again rather than starting a second quote.

read-only

Argument	Type	Description
quoteReference*	string	The quoteReference returned by itinerary_quote.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "quoteReference"
  ],
  "properties": {
    "quoteReference": {
      "type": "string",
      "minLength": 20,
      "description": "The quoteReference returned by itinerary_quote."
    }
  }
}

plan_route

The primary entry point for any multi-city trip. Give it your cities — it automatically evaluates Star Alliance RTW, oneworld RTW, AND custom mixed-carrier builds, then recommends the best approach. Handles direction detection, backtracking analysis, alliance feasibility, surface sectors, and carrier selection. The customer doesn't need to know if their trip is alliance or custom — this tool figures it out.

read-only

Argument	Type	Description
pax	number	Number of passengers
budget	string	Budget tier — affects carrier selection and fare strategy
cities*	array	Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'LIS', 'LAX'])
preferences	array	Travel preferences: 'no-lcc', 'lounge-access', 'short-layovers', 'surface-ok'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities"
  ],
  "properties": {
    "pax": {
      "type": "number",
      "description": "Number of passengers"
    },
    "budget": {
      "enum": [
        "budget",
        "mid",
        "premium",
        "business"
      ],
      "type": "string",
      "description": "Budget tier — affects carrier selection and fare strategy"
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'LIS', 'LAX'])"
    },
    "preferences": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Travel preferences: 'no-lcc', 'lounge-access', 'short-layovers', 'surface-ok'"
    }
  }
}

route_estimate

Get a price range for a multi-city or round-the-world trip, drawn from what AirTreks customers have actually paid on those routes. Give it the cities and it returns a per-person range in USD with how much history sits behind it. Use it when someone asks what a trip will cost and you don't have exact dates yet — it needs no dates and no passenger details. It is a range from past bookings, not a live quote, so it will not reflect today's availability or seasonality; it tells you the right ballpark before anyone commits to dates.

read-only

Argument	Type	Description
cabin	string	Cabin to price. Defaults to economy. 'premium' means premium economy.
cities*	array	Ordered list of IATA city/airport codes for the whole trip, e.g. ['LAX','NRT','BKK','LHR','LAX']. Put '000' between two codes to mark that leg as travelled overland rather than flown, e.g. ['HAN','000','SGN','SYD'].

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities"
  ],
  "properties": {
    "cabin": {
      "enum": [
        "economy",
        "premium",
        "business",
        "first"
      ],
      "type": "string",
      "description": "Cabin to price. Defaults to economy. 'premium' means premium economy."
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 14,
      "minItems": 2,
      "description": "Ordered list of IATA city/airport codes for the whole trip, e.g. ['LAX','NRT','BKK','LHR','LAX']. Put '000' between two codes to mark that leg as travelled overland rather than flown, e.g. ['HAN','000','SGN','SYD']."
    }
  }
}

route_suggest

Get suggested multi-stop flight routings based on regions, direction, and alliance preference. Returns up to 3 proven routing templates with bookability ratings. Great for trip planning inspiration.

read-only

Argument	Type	Description
regions*	array	Regions to visit: 'asia', 'europe', 'oceania', 'americas', 'africa', 'middle east', 'south america'
alliance	string	Preferred alliance: 'star' or 'oneworld'
maxStops	number	Maximum number of stops (legs). 3-6 recommended for best bookability.
tripType	string	Trip type hint: 'honeymoon', 'backpacker', 'business', 'family', etc.
direction	string	Travel direction preference

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "regions"
  ],
  "properties": {
    "regions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Regions to visit: 'asia', 'europe', 'oceania', 'americas', 'africa', 'middle east', 'south america'"
    },
    "alliance": {
      "type": "string",
      "description": "Preferred alliance: 'star' or 'oneworld'"
    },
    "maxStops": {
      "type": "number",
      "description": "Maximum number of stops (legs). 3-6 recommended for best bookability."
    },
    "tripType": {
      "type": "string",
      "description": "Trip type hint: 'honeymoon', 'backpacker', 'business', 'family', etc."
    },
    "direction": {
      "enum": [
        "eastbound",
        "westbound",
        "either"
      ],
      "type": "string",
      "description": "Travel direction preference"
    }
  }
}

route_validate

Validate a multi-city flight routing for feasibility. Checks alliance carrier rules, identifies dead legs, warns about poison carriers, and estimates bookability. Use this before building an itinerary to catch routing problems early.

read-only

Argument	Type	Description
cities*	array	Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'LHR', 'LAX'])
alliance	string	Preferred alliance: 'star' or 'oneworld'
carriers	array	Optional carrier codes for each leg (e.g. ['NH', 'TG', 'BA', 'BA'])

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cities"
  ],
  "properties": {
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ordered list of IATA city/airport codes (e.g. ['LAX', 'NRT', 'BKK', 'LHR', 'LAX'])"
    },
    "alliance": {
      "type": "string",
      "description": "Preferred alliance: 'star' or 'oneworld'"
    },
    "carriers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional carrier codes for each leg (e.g. ['NH', 'TG', 'BA', 'BA'])"
    }
  }
}

trip_idea_create

Submit the customer's trip to AirTreks — a human travel consultant takes over from there. Automatically runs plan_route to attach the full routing analysis and carrier recommendations to the trip request, so the consultant starts informed, not cold. Use this when the customer is ready to get a real quote. Requires the customer's name, email, at least 2 cities (3-letter IATA codes), a departure date for every leg, and answers to AirTreks' planning questions — call once without questionsAnswers to receive the current questions to ask.

destructive

Argument	Type	Description
name*	string	Customer full name (required — the consultant contacts them by name)
cabin	string	Cabin class preference
dates*	array	Departure dates, one per leg (ISO format, e.g. '2026-09-15') — a trip with N cities needs N-1 dates, all required. If the customer is unsure, use their best estimates and set flexibleDates.
email*	string	Customer email address (required)
notes	string	Additional notes or special requests from the customer
phone	string	Customer phone number
budget

AirTreks MCP

Try it

custom_route_build Read-only

AirTreks MCP

Try it

custom_route_build Read-only

Tools (11)