Award Travel Finder

Official136 toolsLive

by AwardTravelFinder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

com.awardtravelfinder/mcp — Model Context Protocol (MCP) Server

This MCP server searches award flight availability and points pricing across 27 airlines and 23 loyalty programs. It exposes 127 award-travel tools over a single hosted endpoint, and is accessed via MCP-compatible clients.

🛠️ Key Features

Search award flight availability
Compare points pricing across 27 airlines and 23 loyalty programs
Provides 127 award-travel tools via one hosted MCP endpoint
Package topics include award-travel, points-and-miles, and model-context-protocol

🚀 Use Cases

Find award flight options
Compare loyalty program redemptions for points

⚡ Developer Benefits

Single endpoint provides many tools (127) behind the MCP interface
Tooling is described as compatible with MCP clients (e.g., Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT, Grok, Antigravity)

⚠️ Limitations

Scope is limited to award-travel data (award flights and points pricing) for the listed airlines and loyalty programs (27 airlines, 23 loyalty programs)

Topics

award-travelclaude-code-pluginmcpmcp-servermodel-context-protocolpoints-and-milesairlinesantigravity-cli-extensionsflightstravelgemini-cli-extension

Captured live from the server via tools/list.

search_all_airlines

Search award flight availability across ALL supported airlines for a route and date. Searches British Airways, Cathay Pacific, Virgin Atlantic, Iberia, Qatar Airways, Alaska Airlines, JetBlue, Frontier, and Southwest in parallel. Returns combined results grouped by airline. This is the recommended starting point — use single-airline search only if you need a specific airline. Requires sign-in. Free accounts get 3 economy searches/day; Premium ($9.99/mo) gets unlimited searches across every cabin.

Parameters5

departure_code	string	required	Departure airport IATA code (e.g. LHR)
arrival_code	string	required	Arrival airport IATA code (e.g. JFK)
date	string	required	Travel date (YYYY-MM-DD)
cabin	string	optional	Cabin to unlock and rank by (default: economy). Results list EVERY bookable cabin the airline returned, not just this one — free accounts may only request economy.
flex_days	integer	optional	Also search this many days either side of the date. Only widens the seats.aero results (all 24 programmes); the per-airline search stays on the exact date.

Raw schema

{
  "type": "object",
  "properties": {
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Departure airport IATA code (e.g. LHR)"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Arrival airport IATA code (e.g. JFK)"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Travel date (YYYY-MM-DD)"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin to unlock and rank by (default: economy). Results list EVERY bookable cabin the airline returned, not just this one — free accounts may only request economy."
    },
    "flex_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 7,
      "description": "Also search this many days either side of the date. Only widens the seats.aero results (all 24 programmes); the per-airline search stays on the exact date."
    }
  },
  "required": [
    "departure_code",
    "arrival_code",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_availability

Search live award availability for a specific airline, route, and date. 27 airlines can be requested, but live coverage varies — when a source is down, blocked, or needs a member login the result says so explicitly instead of reporting zero seats, so never read an unsearchable source as 'no availability'. Requires sign-in. Free accounts get 3 economy searches/day; Premium ($9.99/mo) gets unlimited searches across every cabin.

Parameters5

airline	string	required
departure_code	string	required
arrival_code	string	required
date	string	required
cabin	string	optional	Cabin to unlock and rank by (default: economy). Results list EVERY bookable cabin the airline returned, not just this one — free accounts may only request economy.

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "british_airways",
        "qatar_airways",
        "cathay_pacific",
        "virgin_atlantic",
        "iberia",
        "alaska_airlines",
        "american_airlines",
        "qantas",
        "jetblue",
        "frontier",
        "southwest",
        "delta",
        "etihad",
        "emirates",
        "japan_airlines",
        "united",
        "tap_portugal",
        "cape_air",
        "icelandair",
        "condor",
        "aer_lingus",
        "el_al",
        "turkish_airlines",
        "ana",
        "lufthansa",
        "air_france",
        "klm"
      ]
    },
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin to unlock and rank by (default: economy). Results list EVERY bookable cabin the airline returned, not just this one — free accounts may only request economy."
    }
  },
  "required": [
    "airline",
    "departure_code",
    "arrival_code",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_monthly_availability

Search award flight availability for an entire month. Returns day-by-day availability with points costs. Renders as an interactive rate calendar. Paid feature.

Parameters4

airline	string	required
departure_code	string	required
arrival_code	string	required
date	string	required	Month to search (YYYY-MM or YYYY-MM-DD)

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "british_airways",
        "qatar_airways",
        "cathay_pacific",
        "virgin_atlantic",
        "iberia",
        "qantas",
        "etihad"
      ]
    },
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
      "description": "Month to search (YYYY-MM or YYYY-MM-DD)"
    }
  },
  "required": [
    "airline",
    "departure_code",
    "arrival_code",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_pricing

Get the award pricing chart for a specific airline route. Shows points required per cabin class (off-peak/peak). No date needed. Paid feature.

Parameters3

airline	string	required
departure_code	string	required
arrival_code	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "british_airways",
        "qatar_airways",
        "cathay_pacific",
        "virgin_atlantic",
        "iberia",
        "emirates",
        "qantas"
      ]
    },
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    }
  },
  "required": [
    "airline",
    "departure_code",
    "arrival_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_hybrid

Find the cheapest way to fly by combining cash tickets with award redemptions into one split-ticket journey. Searches cash fares (Google Flights) and award availability across airlines, then combines the best cash leg with the best award leg via connecting hubs. Best for premium cabins (business/first) on long-haul routes. Paid feature.

Parameters5

origin	string	required
destination	string	required
date	string	required
cabin	string	optional	Target cabin class (default: business)
points_value_cents	number	optional	How you value points in cents/pence per point (default: 1.5)

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "business",
        "first"
      ],
      "description": "Target cabin class (default: business)"
    },
    "points_value_cents": {
      "type": "number",
      "description": "How you value points in cents/pence per point (default: 1.5)"
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_award_trip_details

Get flight-level detail for one award result from search_all_airlines or search_availability: flight numbers, aircraft, departure/arrival times, stops, and direct booking links into the mileage programme. Pass the `trip_id` from a seats.aero result row. Requires a connected seats.aero account.

Parameters1

trip_id

string

required

The `trip_id` field from an award search result row

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "string",
      "description": "The `trip_id` field from an award search result row"
    }
  },
  "required": [
    "trip_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_program_rates

Get the full award chart rates for a specific loyalty program. Returns all destinations with points required per cabin class including off-peak/peak pricing. Free — no account needed.

Parameters1

program

string

required

Loyalty program slug (e.g. british-airways, emirates, aeroplan)

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "enum": [
        "british-airways",
        "qatar-airways",
        "singapore-airlines",
        "cathay-pacific",
        "emirates",
        "etihad",
        "flying-blue",
        "aeroplan",
        "turkish-airlines",
        "ana",
        "jetblue",
        "jet2-emirates",
        "virgin-atlantic",
        "iberia",
        "alaska-airlines",
        "american-airlines",
        "qantas",
        "delta-skymiles",
        "united",
        "lifemiles",
        "marriott-bonvoy",
        "hilton-honors",
        "hyatt"
      ],
      "description": "Loyalty program slug (e.g. british-airways, emirates, aeroplan)"
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_buy_points_pricing

Get the cost to buy points/miles for a loyalty program. Returns tiered base purchase pricing and any active bonus promotion. Use to answer 'how much does it cost to buy X Avios/miles/points?' If no program specified, returns all programs with pricing data. Free — no account needed.

Parameters2

program	string	optional	Program slug. Omit to list all available programs.
quantity	integer	optional	Number of points/miles to price (e.g. 50000).

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Program slug. Omit to list all available programs."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of points/miles to price (e.g. 50000)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_status_matches

Get current airline status match offers. Returns active promotions where you can match elite status from one airline to another. Includes direct apply links. Each program also has a detailed FAQ page at awardtravelfinder.com/status-match/{program-slug} with eligibility, requirements, and step-by-step instructions. Free — no account needed.

Parameters1

alliance

string

optional

Filter by airline alliance

Raw schema

{
  "type": "object",
  "properties": {
    "alliance": {
      "type": "string",
      "enum": [
        "SkyTeam",
        "Star Alliance",
        "oneworld"
      ],
      "description": "Filter by airline alliance"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_hotels

Search for hotels by name, city, or brand. Returns hotel codes needed for availability checks and price monitoring. Supports Marriott, Hilton, IHG, and Hyatt. Paid feature.

Parameters3

query	string	required	Hotel name or city
brand	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Hotel name or city"
    },
    "brand": {
      "type": "string",
      "enum": [
        "Marriott",
        "Hilton",
        "IHG",
        "Hyatt"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_hotel_availability

Get current points availability for a hotel on specific dates. Use BEFORE monitor_hotel_price to find the correct rate_plan and current points rate. Paid feature.

Parameters3

hotel_code	string	required	Hotel code or numeric id from search_hotels
check_in_date	string	required
check_out_date	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_code": {
      "type": "string",
      "description": "Hotel code or numeric id from search_hotels"
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "hotel_code",
    "check_in_date",
    "check_out_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

monitor_hotel_price

Start monitoring a hotel points booking for price drops. Checks every 12 hours and sends email alerts when the points rate decreases. Paid feature.

Parameters8

hotel_code	string	required	Hotel code or numeric id from search_hotels
check_in_date	string	required
check_out_date	string	required
original_points	integer	required	TOTAL points cost (per-night rate x nights)
room_type	string	required
rate_plan	string	required
confirmation_number	string	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_code": {
      "type": "string",
      "description": "Hotel code or numeric id from search_hotels"
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "original_points": {
      "type": "integer",
      "minimum": 1,
      "description": "TOTAL points cost (per-night rate x nights)"
    },
    "room_type": {
      "type": "string"
    },
    "rate_plan": {
      "type": "string"
    },
    "confirmation_number": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "hotel_code",
    "check_in_date",
    "check_out_date",
    "original_points",
    "room_type",
    "rate_plan"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

add_hotel_booking

Log a hotel booking to the user's portfolio — award (points, with price-drop monitoring) or cash (paid with money; set kind:"cash" and original_pay_rate_usd). Use hotel_id from search_hotels / get_hotel_availability results. Pass trip_id to file the stay under a workspace Trip so it shows grouped with the matching flights. Works great with Gmail — pull check-in/out dates, room type, rate and confirmation number from the reservation email. Paid feature.

Parameters12

hotel_id	string	required	Hotel identifier from search_hotels / get_hotel_availability results.
check_in_date	string	required
check_out_date	string	required
kind	string	optional	award = points stay with price-drop monitoring (default); cash = paid with money. Defaults to award.
original_points	integer	optional	Award bookings only. Total points paid for the stay.
original_pay_rate_usd	number	optional	Cash rate paid for the stay (required for cash bookings; optional cash-equivalent for award bookings).
cash_rate_currency	string	optional	Currency of original_pay_rate_usd. Defaults to USD.
room_type	string	optional
rate_plan	string	optional
confirmation_number	string	optional
trip_id	integer	optional	Optional id of a workspace Trip (from create_trip / list_trips) to file this stay under.
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel identifier from search_hotels / get_hotel_availability results."
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "award",
        "cash"
      ],
      "description": "award = points stay with price-drop monitoring (default); cash = paid with money. Defaults to award."
    },
    "original_points": {
      "type": "integer",
      "minimum": 1,
      "description": "Award bookings only. Total points paid for the stay."
    },
    "original_pay_rate_usd": {
      "type": "number",
      "minimum": 0,
      "description": "Cash rate paid for the stay (required for cash bookings; optional cash-equivalent for award bookings)."
    },
    "cash_rate_currency": {
      "type": "string",
      "description": "Currency of original_pay_rate_usd. Defaults to USD."
    },
    "room_type": {
      "type": "string"
    },
    "rate_plan": {
      "type": "string"
    },
    "confirmation_number": {
      "type": "string"
    },
    "trip_id": {
      "type": "integer",
      "description": "Optional id of a workspace Trip (from create_trip / list_trips) to file this stay under."
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "hotel_id",
    "check_in_date",
    "check_out_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_hotel_bookings

List all hotel bookings being monitored for price drops. Shows current vs. original points rates.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_hotel_booking

Get details and full price history of a monitored hotel booking.

Parameters1

booking_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_hotel_booking

Update a tracked hotel booking — correct dates, room type, points, rate, confirmation number, etc. Do NOT use this to cancel a booking — use delete_hotel_booking instead.

Parameters13

booking_id	integer	required
hotel_id	string	optional
check_in_date	string	optional
check_out_date	string	optional
kind	string	optional
original_points	integer	optional
original_pay_rate_usd	number	optional
cash_rate_currency	string	optional
room_type	string	optional
rate_plan	string	optional
confirmation_number	string	optional
monitoring_enabled	boolean	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    },
    "hotel_id": {
      "type": "string"
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "award",
        "cash"
      ]
    },
    "original_points": {
      "type": "integer",
      "minimum": 0
    },
    "original_pay_rate_usd": {
      "type": "number",
      "minimum": 0
    },
    "cash_rate_currency": {
      "type": "string"
    },
    "room_type": {
      "type": "string"
    },
    "rate_plan": {
      "type": "string"
    },
    "confirmation_number": {
      "type": "string"
    },
    "monitoring_enabled": {
      "type": "boolean"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_hotel_booking

Remove a tracked hotel booking from the user's portfolio. Use when the trip is cancelled or the booking was added by mistake.

Parameters1

booking_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

add_flight_booking

Log a flight booking/redemption — award (points) or cash (paid with money; set kind:"cash" and cash_paid). For multi-leg trips (connecting flights, open-jaw, return), call this once per leg using the same trip_id — put the total cost on the first leg and 0 on subsequent legs. Works great with Gmail — extract booking details from confirmation emails. Paid feature.

Parameters18

airline	string	required
origin	string	required
destination	string	required
departure_date	string	required
kind	string	optional	award = points/miles redemption (default); cash = paid with money. Defaults to award.
points_spent	integer	optional	Award bookings only. Total points for this leg. Use 0 for connecting legs — put the full booking cost on the first leg only.
program	string	optional	Award bookings only. Loyalty program used.
cash_paid	number	optional	Cash bookings only. Total cash fare paid for this leg, in taxes_currency (default USD).
cabin_class	string	required
trip_id	string	optional	Optional UUID grouping legs of the same multi-leg booking. Generate once and reuse for all legs. Omit for single-leg bookings.
workspace_trip_id	integer	optional	Optional id of a workspace Trip (from create_trip / list_trips) to file this flight under, so it shows grouped with the matching hotels. Distinct from trip_id, which only chains multi-leg legs.
flight_number	string	optional
return_date	string	optional
taxes_paid	number	optional
taxes_currency	string	optional	Currency for taxes_paid and cash_paid. Defaults to USD.
passengers	integer	optional
confirmation_number	string	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string"
    },
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "departure_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "award",
        "cash"
      ],
      "description": "award = points/miles redemption (default); cash = paid with money. Defaults to award."
    },
    "points_spent": {
      "type": "integer",
      "minimum": 0,
      "description": "Award bookings only. Total points for this leg. Use 0 for connecting legs — put the full booking cost on the first leg only."
    },
    "program": {
      "type": "string",
      "description": "Award bookings only. Loyalty program used."
    },
    "cash_paid": {
      "type": "number",
      "minimum": 0,
      "description": "Cash bookings only. Total cash fare paid for this leg, in taxes_currency (default USD)."
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "trip_id": {
      "type": "string",
      "description": "Optional UUID grouping legs of the same multi-leg booking. Generate once and reuse for all legs. Omit for single-leg bookings."
    },
    "workspace_trip_id": {
      "type": "integer",
      "description": "Optional id of a workspace Trip (from create_trip / list_trips) to file this flight under, so it shows grouped with the matching hotels. Distinct from trip_id, which only chains multi-leg legs."
    },
    "flight_number": {
      "type": "string"
    },
    "return_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "taxes_paid": {
      "type": "number"
    },
    "taxes_currency": {
      "type": "string",
      "description": "Currency for taxes_paid and cash_paid. Defaults to USD."
    },
    "passengers": {
      "type": "integer",
      "minimum": 1
    },
    "confirmation_number": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "airline",
    "origin",
    "destination",
    "departure_date",
    "cabin_class"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_flight_bookings

List all tracked flight award bookings/redemptions. Shows airlines, routes, points spent, and cabin classes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_flight_booking

Get details of a specific flight booking/redemption.

Parameters1

booking_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_flight_booking

Update a tracked flight booking. Use to correct details or add confirmation numbers. Do NOT use this to cancel a booking — use delete_flight_booking instead.

Parameters16

booking_id	integer	required
airline	string	optional
flight_number	string	optional
origin	string	optional
destination	string	optional
departure_date	string	optional
return_date	string	optional
cabin_class	string	optional
kind	string	optional
points_spent	integer	optional
program	string	optional
cash_paid	number	optional
taxes_paid	number	optional
trip_id	string	optional
confirmation_number	string	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    },
    "airline": {
      "type": "string"
    },
    "flight_number": {
      "type": "string"
    },
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "departure_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "return_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "award",
        "cash"
      ]
    },
    "points_spent": {
      "type": "integer",
      "minimum": 0
    },
    "program": {
      "type": "string"
    },
    "cash_paid": {
      "type": "number",
      "minimum": 0
    },
    "taxes_paid": {
      "type": "number"
    },
    "trip_id": {
      "type": "string"
    },
    "confirmation_number": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_flight_booking

Cancel or remove a tracked flight booking. Use this when the user says the flight is cancelled, superseded, no longer happening, or asks to remove/archive it.

Parameters1

booking_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_voucher_types

Browse the catalogue of companion & upgrade voucher types (UK + US): BA Amex companion (Travel Together), Barclaycard/Lloyds Avios upgrade vouchers, Virgin Atlantic companion, Delta/American/Alaska companion certificates, Southwest Companion Pass, United PlusPoints. Optionally filter by region (UK/US) or category. Free reference data.

Parameters2

region	string	optional	Filter by issuer region.
category	string	optional	Filter by voucher category.

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "enum": [
        "UK",
        "US"
      ],
      "description": "Filter by issuer region."
    },
    "category": {
      "type": "string",
      "enum": [
        "companion",
        "upgrade",
        "companion_pass",
        "upgrade_cert"
      ],
      "description": "Filter by voucher category."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_my_vouchers

List the companion/upgrade vouchers the user holds, including which booking each is applied to. Paid feature.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

add_voucher

Add a companion/upgrade voucher the user holds to their inventory. Use list_voucher_types to find the voucher_slug. Paid feature.

Parameters4

voucher_slug	string	required	Slug from list_voucher_types, e.g. 'ba-amex-premium-plus-companion'.
expires_on	string	optional	Voucher expiry date (YYYY-MM-DD).
reference	string	optional	Voucher code or membership reference.
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "voucher_slug": {
      "type": "string",
      "description": "Slug from list_voucher_types, e.g. 'ba-amex-premium-plus-companion'."
    },
    "expires_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Voucher expiry date (YYYY-MM-DD)."
    },
    "reference": {
      "type": "string",
      "description": "Voucher code or membership reference."
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "voucher_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

apply_voucher_to_booking

Apply a held voucher to a flight or hotel booking (e.g. a BA companion voucher onto a flight redemption, or a Barclaycard upgrade voucher onto a Club World leg). Omit booking_id to detach the voucher. Paid feature.

Parameters3

voucher_id	integer	required	ID of the user's voucher (from list_my_vouchers).
booking_type	string	optional	Whether booking_id refers to a flight redemption or a hotel booking.
booking_id	integer	optional	ID of the booking to apply the voucher to. Omit to detach.

Raw schema

{
  "type": "object",
  "properties": {
    "voucher_id": {
      "type": "integer",
      "minimum": 1,
      "description": "ID of the user's voucher (from list_my_vouchers)."
    },
    "booking_type": {
      "type": "string",
      "enum": [
        "flight",
        "hotel"
      ],
      "description": "Whether booking_id refers to a flight redemption or a hotel booking."
    },
    "booking_id": {
      "type": "integer",
      "minimum": 1,
      "description": "ID of the booking to apply the voucher to. Omit to detach."
    }
  },
  "required": [
    "voucher_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_voucher

Remove a voucher from the user's inventory.

Parameters1

voucher_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "voucher_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "voucher_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_points_balance

Update your points/miles balance for a loyalty program. Creates the program if it doesn't exist, or updates the balance if it does. Use with Gmail to extract balance notifications and keep your portfolio current. Paid feature.

Parameters2

program	string	required	Loyalty program name
balance	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Loyalty program name"
    },
    "balance": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "program",
    "balance"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_points_balances

List all your loyalty program points/miles balances.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_points_balance

Remove a loyalty program from your points balances — e.g. you closed the account or added it by mistake. Use the program name as shown by list_points_balances. Paid feature.

Parameters1

program

string

required

Loyalty program name to remove (as shown by list_points_balances)

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Loyalty program name to remove (as shown by list_points_balances)"
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

set_loyalty_status

Record or update the user's elite/loyalty status with an airline or hotel program (e.g. Marriott Bonvoy Titanium, BA Executive Club Gold, AA Executive Platinum). Knowing this lets the assistant flag perks like free breakfast, suite upgrades, lounge access, and free award nights when planning trips. Use exact tier names from the reference table: British Airways Executive Club → Blue/Bronze/Silver/Gold; Delta SkyMiles → Silver/Gold/Platinum/Diamond Medallion; Marriott Bonvoy → Member/Silver Elite/Gold Elite/Platinum Elite/Titanium Elite/Ambassador Elite; World of Hyatt → Member/Discoverist/Explorist/Globalist.

Parameters8

program	string	required	Loyalty program slug — e.g. 'british-airways-executive-club', 'marriott-bonvoy', 'world-of-hyatt', 'delta-skymiles'. Use the slug from the known programs list.
tier	string	required	Exact elite tier name as used by the program — e.g. 'Gold' (BA), 'Diamond Medallion' (Delta), 'Globalist' (Hyatt), 'Titanium Elite' (Bonvoy). Case-insensitive; will be normalized to official casing.
member_id	string	optional	Optional loyalty number.
expires_on	string	optional	Optional ISO date when this status expires.
qualifying_balance	integer	optional	Optional — current qualifying units this period (Tier Points / XP / Loyalty Points / MQD / PQP / nights), for status-progress tracking.
qualifying_year_end	string	optional	Optional — ISO date the qualifying/membership year ends.
target_tier	string	optional	Optional — a tier the user is chasing (must be a valid tier for the program).
notes	string	optional	Optional notes (free-form).

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Loyalty program slug — e.g. 'british-airways-executive-club', 'marriott-bonvoy', 'world-of-hyatt', 'delta-skymiles'. Use the slug from the known programs list."
    },
    "tier": {
      "type": "string",
      "description": "Exact elite tier name as used by the program — e.g. 'Gold' (BA), 'Diamond Medallion' (Delta), 'Globalist' (Hyatt), 'Titanium Elite' (Bonvoy). Case-insensitive; will be normalized to official casing."
    },
    "member_id": {
      "type": "string",
      "description": "Optional loyalty number."
    },
    "expires_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional ISO date when this status expires."
    },
    "qualifying_balance": {
      "type": "integer",
      "minimum": 0,
      "description": "Optional — current qualifying units this period (Tier Points / XP / Loyalty Points / MQD / PQP / nights), for status-progress tracking."
    },
    "qualifying_year_end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional — ISO date the qualifying/membership year ends."
    },
    "target_tier": {
      "type": "string",
      "description": "Optional — a tier the user is chasing (must be a valid tier for the program)."
    },
    "notes": {
      "type": "string",
      "description": "Optional notes (free-form)."
    }
  },
  "required": [
    "program",
    "tier"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_loyalty_statuses

List the user's tracked elite/loyalty statuses across airlines and hotels.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_loyalty_status

Remove a tracked elite/loyalty status (e.g. when it lapses and the user doesn't want to renew it).

Parameters1

program

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string"
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

set_status_progress

Update the user's qualifying progress toward an elite tier — their current tier-points / XP / Loyalty Points / qualifying nights, the date their qualifying year ends, and (optionally) a target tier they're chasing. Use this to answer 'how far am I from BA Gold?'. If no status is tracked for the program yet, also pass `tier` (the user's CURRENT tier) and it will be created. Programs use different qualifying currencies — BA/Virgin: Tier Points; Flying Blue: XP; AA: Loyalty Points; United: PQP; Delta: MQD; hotels: nights.

Parameters5

program	string	required	Loyalty program slug — e.g. 'british-airways-executive-club', 'marriott-bonvoy'.
qualifying_balance	integer	optional	Current qualifying units earned this period (Tier Points / XP / Loyalty Points / MQD / PQP / nights).
qualifying_year_end	string	optional	ISO date the current qualifying/membership year ends (e.g. BA membership years are anchored to the join date — ask the user).
target_tier	string	optional	Optional tier the user is chasing — e.g. 'Gold'. Must be a valid tier for the program. Defaults the progress bar to this instead of the next tier up.
tier	string	optional	Optional — the user's CURRENT tier. Required only if no status is tracked for this program yet.

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Loyalty program slug — e.g. 'british-airways-executive-club', 'marriott-bonvoy'."
    },
    "qualifying_balance": {
      "type": "integer",
      "minimum": 0,
      "description": "Current qualifying units earned this period (Tier Points / XP / Loyalty Points / MQD / PQP / nights)."
    },
    "qualifying_year_end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "ISO date the current qualifying/membership year ends (e.g. BA membership years are anchored to the join date — ask the user)."
    },
    "target_tier": {
      "type": "string",
      "description": "Optional tier the user is chasing — e.g. 'Gold'. Must be a valid tier for the program. Defaults the progress bar to this instead of the next tier up."
    },
    "tier": {
      "type": "string",
      "description": "Optional — the user's CURRENT tier. Required only if no status is tracked for this program yet."
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_status_progress

Show the user's progress toward elite status across all their tracked loyalty programs — for each: current tier, qualifying balance, the next tier's threshold and what it unlocks, how far they are from it, and their requalification date. Answers 'how close am I to my next tier?' and 'what would the next tier get me?'. Read-only.

Parameters1

program

string

optional

Optional — limit to a single program slug. Omit to return all tracked statuses.

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Optional — limit to a single program slug. Omit to return all tracked statuses."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

calculate_flight_earnings

Estimate the ELITE-QUALIFYING points a flight earns toward status — British Airways Tier Points, Air France/KLM Flying Blue XP, or American AAdvantage Loyalty Points — plus the great-circle distance. Answers 'how many tier points is LHR–JFK in business?' and 'how many BA tier points for a £600 fare?'. Tier Points and Loyalty Points are revenue-based (pass `fare_price`); Flying Blue XP is fixed per segment by distance + cabin. Use program slugs: 'british-airways-executive-club', 'air-france-klm-flying-blue', 'american-aadvantage'.

Parameters7

origin	string	required	Origin airport IATA code, e.g. 'LHR'.
destination	string	required	Destination airport IATA code, e.g. 'JFK'.
program	string	required	Qualifying program slug: 'british-airways-executive-club', 'air-france-klm-flying-blue', or 'american-aadvantage'.
cabin	string	optional	Cabin: economy, premium, business, or first.
fare_price	number	optional	Fare price for revenue-based programs (BA Tier Points, AA Loyalty Points). Base fare + carrier surcharges, excluding taxes.
fare_currency	string	optional	ISO currency of fare_price (e.g. GBP, USD, EUR). Defaults to the program's home currency.
segments	integer	optional	Number of flight segments/legs (multiplies Flying Blue XP). Default 1.

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin airport IATA code, e.g. 'LHR'."
    },
    "destination": {
      "type": "string",
      "description": "Destination airport IATA code, e.g. 'JFK'."
    },
    "program": {
      "type": "string",
      "description": "Qualifying program slug: 'british-airways-executive-club', 'air-france-klm-flying-blue', or 'american-aadvantage'."
    },
    "cabin": {
      "type": "string",
      "description": "Cabin: economy, premium, business, or first.",
      "default": "economy"
    },
    "fare_price": {
      "type": "number",
      "description": "Fare price for revenue-based programs (BA Tier Points, AA Loyalty Points). Base fare + carrier surcharges, excluding taxes."
    },
    "fare_currency": {
      "type": "string",
      "description": "ISO currency of fare_price (e.g. GBP, USD, EUR). Defaults to the program's home currency."
    },
    "segments": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of flight segments/legs (multiplies Flying Blue XP). Default 1."
    }
  },
  "required": [
    "origin",
    "destination",
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

recommend_status_path

Recommend the cheapest path to an elite tier — EARN it through planned flying, RUN for it (a tier-point run), or MATCH/challenge into it from a status the user already holds. Uses the user's tracked statuses, booked flights, and the status-match graph. Answers 'what's the easiest way to get Qatar Gold?'. Premium. Pass the target program slug (e.g. 'qatar-privilege-club') and optionally a target tier; defaults to the next tier up from what they hold, else the top tier.

Parameters2

target_program	string	required	Program slug to reach status with — e.g. 'qatar-privilege-club', 'british-airways-executive-club'.
target_tier	string	optional	Optional target tier (e.g. 'Gold'). Defaults to the next tier above the user's current one, or the top tier.

Raw schema

{
  "type": "object",
  "properties": {
    "target_program": {
      "type": "string",
      "description": "Program slug to reach status with — e.g. 'qatar-privilege-club', 'british-airways-executive-club'."
    },
    "target_tier": {
      "type": "string",
      "description": "Optional target tier (e.g. 'Gold'). Defaults to the next tier above the user's current one, or the top tier."
    }
  },
  "required": [
    "target_program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_award_release_window

Look up when an airline opens award seats for booking (days from departure). Use this before searching for a date >330 days out to warn the user if inventory hasn't been loaded yet, and to suggest the right retry date or a route monitor.

Parameters1

airline

string

required

IATA code (e.g. 'BA') or carrier name (e.g. 'British Airways').

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string",
      "description": "IATA code (e.g. 'BA') or carrier name (e.g. 'British Airways')."
    }
  },
  "required": [
    "airline"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_award_release_windows

List all known per-airline award booking windows. Useful when the user asks 'when do award seats open?' generally.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_portfolio

Get a complete summary of your travel rewards portfolio for signed-in users: points balances, spend on hotels and flights, upcoming and past trips, destinations, and monthly spending trends. Uses the same underlying snapshot as the server-loaded chat preamble; call after the user adds bookings or balances in-session when you need a refresh.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

log_lounge_visit

Log an airport lounge visit to your portfolio: which lounge, airport, date, how you got in (Priority Pass, card, status, ticket), an optional 1-5 rating, and notes. Use with the lounge_* lookup tools to confirm the lounge name first. Paid feature.

Parameters6

airport_code	string	required	Airport IATA code, e.g. LHR
lounge_name	string	required	Lounge name, e.g. Qantas First Lounge
visit_date	string	required	Date of the visit (YYYY-MM-DD)
access_method	string	optional	How you got in, e.g. Priority Pass, Amex Platinum, business ticket
rating	integer	optional	Optional 1-5 rating
notes	string	optional	Optional notes

Raw schema

{
  "type": "object",
  "properties": {
    "airport_code": {
      "type": "string",
      "description": "Airport IATA code, e.g. LHR"
    },
    "lounge_name": {
      "type": "string",
      "description": "Lounge name, e.g. Qantas First Lounge"
    },
    "visit_date": {
      "type": "string",
      "description": "Date of the visit (YYYY-MM-DD)"
    },
    "access_method": {
      "type": "string",
      "description": "How you got in, e.g. Priority Pass, Amex Platinum, business ticket"
    },
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Optional 1-5 rating"
    },
    "notes": {
      "type": "string",
      "description": "Optional notes"
    }
  },
  "required": [
    "airport_code",
    "lounge_name",
    "visit_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_lounge_visits

List the airport lounge visits you've logged to your portfolio.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_lounge_visit

Remove a lounge visit you previously logged with log_lounge_visit. Use list_lounge_visits to find the visit id. Paid feature.

Parameters1

visit_id

integer

required

Id of the logged visit, from list_lounge_visits.

Raw schema

{
  "type": "object",
  "properties": {
    "visit_id": {
      "type": "integer",
      "description": "Id of the logged visit, from list_lounge_visits."
    }
  },
  "required": [
    "visit_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

discover_more_flight_tools

Discover other flight & travel MCP servers you can add to your client. Lists complementary remote MCPs covering aircraft seatmaps, airport delays/wait times, and lounges — with one-line install URLs. Call this when the user asks about seat selection, airport delays/security waits, baggage rankings, lounges, or 'what other flight tools are there?'

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_integrations

List the external services the user can connect (seats.aero, AwardWallet, etc.) and their current connection status. Call this before any flight/hotel search if you suspect a connection is missing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

connect_integration

Initiate the OAuth flow to connect an external integration. Returns the authorize URL; the user must open it in a browser to grant access. Use this when a tool returns connection_required.

Parameters1

provider

string

required

Which integration to connect

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "seats_aero",
        "award_wallet",
        "google_sheets",
        "tripit",
        "autopilot"
      ],
      "description": "Which integration to connect"
    }
  },
  "required": [
    "provider"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

disconnect_integration

Revoke a previously connected integration. The OAuth tokens are deleted from ATF storage.

Parameters1

provider

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "seats_aero",
        "award_wallet",
        "google_sheets",
        "tripit",
        "autopilot"
      ]
    }
  },
  "required": [
    "provider"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

sync_now

Trigger an immediate refresh of the user's connected integrations (AwardWallet, Google Sheets, …) so balances/bookings are current before you answer. Use when the user asks to refresh, or when list_integrations shows stale data. Returns which connections are syncing.

Parameters1

provider

string

optional

Optional — sync just this provider. Omit to sync all connected integrations.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "seats_aero",
        "award_wallet",
        "google_sheets",
        "tripit",
        "autopilot"
      ],
      "description": "Optional — sync just this provider. Omit to sync all connected integrations."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

whats_on_sale

List currently-active points sales: buy-points promos (airline + hotel) and transfer bonuses across credit-card and loyalty programs. No auth required. Useful as a starting point when a user asks 'what's a good deal right now?'.

Parameters2

category	string	optional	Filter (default: all)
program	string	optional	Filter to a single program (e.g. 'Avios', 'Marriott Bonvoy')

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "all",
        "airline",
        "hotel",
        "transfer"
      ],
      "description": "Filter (default: all)"
    },
    "program": {
      "type": "string",
      "description": "Filter to a single program (e.g. 'Avios', 'Marriott Bonvoy')"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

recommend_redemption

Recommend the optimal points strategy for a specific trip given the user's known points balances. Combines active award availability + transfer bonuses + the user's portfolio. Premium tier.

Parameters5

origin	string	required
destination	string	required
date	string	required
cabin	string	optional
passengers	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

audit_marriott_folio

Audit a Marriott Bonvoy folio for commonly-disputable charges (resort fee on award stays, parking double-billing, destination fee, internet). Returns a finding list with a dispute template. Premium tier.

Parameters4

folio_text	string	required
stay_type	string	optional
status_tier	string	optional
confirmation_number	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "folio_text": {
      "type": "string"
    },
    "stay_type": {
      "type": "string",
      "enum": [
        "award",
        "cash",
        "points_advance"
      ]
    },
    "status_tier": {
      "type": "string",
      "enum": [
        "member",
        "silver",
        "gold",
        "platinum",
        "titanium",
        "ambassador"
      ]
    },
    "confirmation_number": {
      "type": "string"
    }
  },
  "required": [
    "folio_text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

compare_transfer_options

Decide which points to use for a specific redemption. Given a target loyalty program and how many points it costs, ranks every transfer route from the user's own balances by real cash cost (cents-per-point), including multi-hop routes, active transfer bonuses, and how long each transfer takes to post. Premium tier.

Parameters2

target_program	string	required	The program you need points in (e.g. 'Asia Miles', 'Avios', 'Aeroplan', 'Virgin Points')
points_needed	integer	required	How many target-program points the redemption costs

Raw schema

{
  "type": "object",
  "properties": {
    "target_program": {
      "type": "string",
      "description": "The program you need points in (e.g. 'Asia Miles', 'Avios', 'Aeroplan', 'Virgin Points')"
    },
    "points_needed": {
      "type": "integer",
      "minimum": 1,
      "description": "How many target-program points the redemption costs"
    }
  },
  "required": [
    "target_program",
    "points_needed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

find_transfer_paths

Find all transfer routes (direct AND multi-hop) to move points from one program to another, e.g. 'Amex Membership Rewards' to 'American Airlines AAdvantage'. Surfaces non-obvious second-hop routes through hotel programs, applies live transfer bonuses, and computes source points needed. Use when a card/program has no direct partner with the target.

Parameters4

from_program	string	required	Program you have points in (e.g. 'Amex Membership Rewards', 'Chase', 'Marriott Bonvoy')
target_program	string	required	Program you want points in (e.g. 'American Airlines AAdvantage', 'Alaska', 'Avios')
points_needed	integer	optional	Optional: how many target-program points you need. Returns source points required per route.
max_hops	integer	optional	Max transfer steps to consider (default 3)

Raw schema

{
  "type": "object",
  "properties": {
    "from_program": {
      "type": "string",
      "description": "Program you have points in (e.g. 'Amex Membership Rewards', 'Chase', 'Marriott Bonvoy')"
    },
    "target_program": {
      "type": "string",
      "description": "Program you want points in (e.g. 'American Airlines AAdvantage', 'Alaska', 'Avios')"
    },
    "points_needed": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional: how many target-program points you need. Returns source points required per route."
    },
    "max_hops": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3,
      "description": "Max transfer steps to consider (default 3)"
    }
  },
  "required": [
    "from_program",
    "target_program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_route_monitor

Create a saved route monitor. ATF checks every 12h for award seats matching the route + window + cabin and emails when fresh availability appears. Free accounts get one monitor; Premium is unlimited.

Parameters8

origin	string	required
destination	string	required
cabin	string	optional
earliest_date	string	required
latest_date	string	required
airlines	array	optional	Optional airline filter; omit to watch all supported carriers
passengers	integer	optional
max_points	integer	optional	Only fire when points <= this cap

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "earliest_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "latest_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "airlines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional airline filter; omit to watch all supported carriers"
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "max_points": {
      "type": "integer",
      "description": "Only fire when points <= this cap"
    }
  },
  "required": [
    "origin",
    "destination",
    "earliest_date",
    "latest_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_route_monitors

List the user's saved route monitors with their last-checked time and current status.

Parameters3

status	string	optional
page	integer	optional	Page number (1-indexed). Defaults to 1.
per_page	integer	optional	Items per page (default 20, max 100).

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "all",
        "active",
        "paused",
        "cancelled",
        "fired"
      ]
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-indexed). Defaults to 1."
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Items per page (default 20, max 100)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_route_monitor

Edit a saved route monitor by ID — change the date window, cabin, airline filter, passenger count, max-points cap, or pause/resume it.

Parameters8

monitor_id	integer	required
cabin	string	optional
earliest_date	string	optional
latest_date	string	optional
airlines	array	optional	Replaces the existing airline filter; pass [] to watch all carriers
passengers	integer	optional
max_points	integer	optional
status	string	optional	Pause or resume the monitor

Raw schema

{
  "type": "object",
  "properties": {
    "monitor_id": {
      "type": "integer"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "earliest_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "latest_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "airlines": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Replaces the existing airline filter; pass [] to watch all carriers"
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "max_points": {
      "type": "integer"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused"
      ],
      "description": "Pause or resume the monitor"
    }
  },
  "required": [
    "monitor_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cancel_route_monitor

Cancel an active route monitor by ID. Cancelled monitors stop firing but are preserved for history.

Parameters1

monitor_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "monitor_id": {
      "type": "integer"
    }
  },
  "required": [
    "monitor_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_standing_order

Save a recurring instruction ATF runs for the user unattended, then emails the result. Use for anything the user wants checked repeatedly without asking — e.g. 'every Sunday check whether LHR-NRT business opens on any programme I hold points for' or 'each morning tell me if any of my tracked bookings dropped in price'. Write `prompt` as a complete, self-contained instruction: it runs with no conversation history, so name the routes, programmes, cabins and dates explicitly. Premium only.

Parameters5

prompt	string	required	The self-contained instruction to run each time. No conversation context is carried over.
cadence	string	optional	Defaults to weekly.
run_hour	integer	optional	Hour of day in UTC to run. Defaults to 7.
run_weekday	integer	optional	0=Sunday … 6=Saturday. Weekly cadence only. Defaults to Monday (1).
trip_id	integer	optional	Optional trip to file this order under.

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The self-contained instruction to run each time. No conversation context is carried over."
    },
    "cadence": {
      "type": "string",
      "enum": [
        "daily",
        "weekly"
      ],
      "description": "Defaults to weekly."
    },
    "run_hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23,
      "description": "Hour of day in UTC to run. Defaults to 7."
    },
    "run_weekday": {
      "type": "integer",
      "minimum": 0,
      "maximum": 6,
      "description": "0=Sunday … 6=Saturday. Weekly cadence only. Defaults to Monday (1)."
    },
    "trip_id": {
      "type": "integer",
      "description": "Optional trip to file this order under."
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_standing_orders

List the user's standing orders — the recurring instructions ATF runs unattended — with their schedule, next run time, and the result of the last run.

Parameters1

include_inactive

boolean

optional

Include cancelled/paused orders. Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "include_inactive": {
      "type": "boolean",
      "description": "Include cancelled/paused orders. Defaults to false."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cancel_standing_order

Stop a standing order by ID so it no longer runs. The record is kept, including its last result.

Parameters1

standing_order_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "standing_order_id": {
      "type": "integer"
    }
  },
  "required": [
    "standing_order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_multi_passenger

Find award seats for a group — filters out single-seat phantom availability. Returns only carriers reporting seats >= the requested passenger count. Premium tier.

Parameters5

departure_code	string	required
arrival_code	string	required
date	string	required
cabin	string	optional
passengers	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "passengers": {
      "type": "integer",
      "minimum": 2,
      "maximum": 9
    }
  },
  "required": [
    "departure_code",
    "arrival_code",
    "date",
    "passengers"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

audit_hotel_folio

Audit a hotel folio for commonly-disputable charges. Supports Marriott, Hilton, Hyatt, and IHG. Returns a finding list with a chain-aware dispute template. Premium tier.

Parameters5

chain	string	required
folio_text	string	required
stay_type	string	optional
status_tier	string	optional
confirmation_number	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "enum": [
        "marriott",
        "hilton",
        "hyatt",
        "ihg"
      ]
    },
    "folio_text": {
      "type": "string"
    },
    "stay_type": {
      "type": "string",
      "enum": [
        "award",
        "cash",
        "points_advance"
      ]
    },
    "status_tier": {
      "type": "string"
    },
    "confirmation_number": {
      "type": "string"
    }
  },
  "required": [
    "chain",
    "folio_text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

plan_trip

Plan an end-to-end award trip in one call. Searches all airlines, ranks options against the user's balances + active transfer bonuses, and surfaces the best route — including transfer paths if the user is short on points. Premium tier.

Parameters6

origin	string	required
destination	string	required
date	string	required
cabin	string	optional
passengers	integer	optional
flexibility_days	integer	optional	Optional ± days flexibility — if set, also probes adjacent dates

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "flexibility_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 14,
      "description": "Optional ± days flexibility — if set, also probes adjacent dates"
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_cash_flights

Real cash flight prices via Duffel (GDS) and Ignav (REST). Use to compare cash vs award redemptions or to surface the cheapest cash option for a route. Returns price + airline + flight number + cabin per option. Hosted keys — no per-user setup.

Parameters7

origin	string	required
destination	string	required
date	string	required
cabin	string	optional
passengers	integer	optional
source	string	optional	Default 'auto' tries Duffel, then Ignav, then AirTRFX. Force one with 'duffel', 'ignav' or 'airtrfx'.
airline	string	optional	Airline slug for the 'airtrfx' source (e.g. 'american', 'klm'). AirTRFX is per-airline, so this is required to use it.

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "source": {
      "type": "string",
      "enum": [
        "auto",
        "duffel",
        "ignav",
        "airtrfx"
      ],
      "description": "Default 'auto' tries Duffel, then Ignav, then AirTRFX. Force one with 'duffel', 'ignav' or 'airtrfx'."
    },
    "airline": {
      "type": "string",
      "description": "Airline slug for the 'airtrfx' source (e.g. 'american', 'klm'). AirTRFX is per-airline, so this is required to use it."
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

find_premium_hotels

Find Amex Fine Hotels & Resorts (FHR), Amex The Hotel Collection (THC), or Chase Edit hotels in a city. These programs stack benefits worth $300+: breakfast, F&B credits, room upgrades, late checkout. Use when the user wants premium hotel options that maximize portal stacking.

Parameters2

city	string	optional	City name to search (e.g. 'Tokyo', 'Maldives'). Optional — omit to list all premium hotels.
program	string	optional	Filter by program. Default: any.

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name to search (e.g. 'Tokyo', 'Maldives'). Optional — omit to list all premium hotels."
    },
    "program": {
      "type": "string",
      "enum": [
        "any",
        "amex_fhr",
        "amex_thc",
        "chase_edit"
      ],
      "description": "Filter by program. Default: any."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_skills

List the reference skills available — institutional knowledge the agent can pull in on demand. Each skill explains a sub-domain (sweet spots, hold rules, cabin codes, etc). Free, no auth required.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_skill

Fetch the full markdown body of a reference skill by key. Use when planning multi-step workflows where the skill's rules matter.

Parameters1

key

string

required

Skill key from list_skills

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Skill key from list_skills"
    }
  },
  "required": [
    "key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_knowledge_base

Search the Miles & Points Daily + Smart With Points editorial archive for explainers and strategy. Use when the user asks 'how does X work', 'should I transfer to Y', 'best way to redeem Z', credit-card or transfer-bonus strategy questions, or anything that benefits from authoritative context. Returns ranked article excerpts with URLs to cite.

Parameters3

query	string	required	Natural-language question or topic, e.g. 'best Avios redemption sweet spots from London'
limit	integer	optional	How many excerpts to return (default 5)
source	string	optional	Restrict to one publication. Omit to search both.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural-language question or topic, e.g. 'best Avios redemption sweet spots from London'"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many excerpts to return (default 5)"
    },
    "source": {
      "type": "string",
      "enum": [
        "miles_and_points_daily",
        "smart_with_points"
      ],
      "description": "Restrict to one publication. Omit to search both."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

wikipedia_airports

Look up airline service from a Wikipedia airport page. Use when fare/award tools say a route doesn't exist (false negative on small markets) or when you need the full destination list for an airport. Free, no auth.

Parameters3

airport_code	string	required	IATA (3-letter) or ICAO (4-letter) airport code
airline	string	optional	Optional — filter the result to this airline name (substring match)
destination	string	optional	Optional — filter to flights serving this destination IATA or city

Raw schema

{
  "type": "object",
  "properties": {
    "airport_code": {
      "type": "string",
      "pattern": "^[A-Z]{3,4}$",
      "description": "IATA (3-letter) or ICAO (4-letter) airport code"
    },
    "airline": {
      "type": "string",
      "description": "Optional — filter the result to this airline name (substring match)"
    },
    "destination": {
      "type": "string",
      "description": "Optional — filter to flights serving this destination IATA or city"
    }
  },
  "required": [
    "airport_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_earning_rates

Look up mileage earning rates for crediting a partner-airline ticket to a loyalty program. Returns the % of distance earned per booking class. Use when deciding which program to credit a flight to. Free.

Parameters3

program	string	required	Loyalty program to credit to
airline	string	required	Operating airline IATA code (e.g. AA, BA, QR)
fare_class	string	optional	Optional booking class letter (e.g. K, M, Y). If omitted, returns the full table for that program×airline.

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "enum": [
        "british-airways",
        "aeroplan",
        "alaska",
        "american-aadvantage",
        "virgin-atlantic",
        "flying-blue"
      ],
      "description": "Loyalty program to credit to"
    },
    "airline": {
      "type": "string",
      "pattern": "^[A-Z0-9]{2}$",
      "description": "Operating airline IATA code (e.g. AA, BA, QR)"
    },
    "fare_class": {
      "type": "string",
      "description": "Optional booking class letter (e.g. K, M, Y). If omitted, returns the full table for that program×airline."
    }
  },
  "required": [
    "program",
    "airline"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_partner_award_options

Given an operating airline and a route, list which loyalty programmes can book that airline as a PARTNER and how many points it costs per cabin. Example: a Korean Air (KE) flight ICN→LAX can be booked with Virgin Points. Use this to answer 'which of my programmes can book this flight and what's the cheapest?'. Points are off-peak/saver estimates from published partner award charts. Free — no account needed.

Parameters3

carrier	string	required	Operating airline IATA code (2 letters, e.g. KE for Korean Air, AF for Air France).
departure	string	required	Origin airport IATA code (e.g. ICN).
destination	string	required	Destination airport IATA code (e.g. LAX).

Raw schema

{
  "type": "object",
  "properties": {
    "carrier": {
      "type": "string",
      "description": "Operating airline IATA code (2 letters, e.g. KE for Korean Air, AF for Air France)."
    },
    "departure": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin airport IATA code (e.g. ICN)."
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination airport IATA code (e.g. LAX)."
    }
  },
  "required": [
    "carrier",
    "departure",
    "destination"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_program_partner_chart

Get a loyalty programme's PARTNER airline award chart (the points to book partner-operated flights), as a region-pair or distance-band table with sources, confidence, and accuracy caveats. Supported: aeroplan (Air Canada), aadvantage (American), singapore-krisflyer, cathay-asia-miles (distance-based), turkish-miles-smiles, ana-mileage-club. Match the route's origin/destination regions (or distance) to a row to read the points cost. IMPORTANT: read the returned `confidence`, `caveats`, and `trip_basis` fields — points are one-way unless trip_basis says round_trip (ANA is round-trip), and these charts apply to PARTNER-operated flights, not the programme's own dynamically-priced flights. Free — no account needed.

Parameters1

program

string

required

Programme slug.

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "enum": [
        "aeroplan",
        "aadvantage",
        "singapore-krisflyer",
        "cathay-asia-miles",
        "turkish-miles-smiles",
        "ana-mileage-club"
      ],
      "description": "Programme slug."
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lookup_flight

Identify the airline behind a pasted flight code (e.g. 'BA117', 'AA 1234'). Returns carrier name, country, and — when ATF supports the airline — the slug and loyalty program so the assistant can pre-fill an add_flight_booking call. Use this any time a user pastes or types a raw flight code without context.

Parameters1

flight_code

string

required

A flight code like 'BA117', 'AA 1234', or 'EK521'.

Raw schema

{
  "type": "object",
  "properties": {
    "flight_code": {
      "type": "string",
      "description": "A flight code like 'BA117', 'AA 1234', or 'EK521'."
    }
  },
  "required": [
    "flight_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_trip_briefing

Combine FlightSeatmap and FlightQueue data for a planned flight: aircraft and seatmap availability plus airport delay and security-wait snapshots. Use when a user asks how to prepare for a flight or wants one live flight brief.

Parameters4

flight_number	string	required	Flight code such as BA117 or AA 100
flight_date	string	optional	Optional departure date
origin	string	optional	Optional departure airport IATA code
destination	string	optional	Optional arrival airport IATA code

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{2,3}\\s*\\d{1,4}$",
      "description": "Flight code such as BA117 or AA 100"
    },
    "flight_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional departure date"
    },
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Optional departure airport IATA code"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Optional arrival airport IATA code"
    }
  },
  "required": [
    "flight_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

list_trips

List the signed-in user's trips (their trip-as-project workspaces) with destination, dates, status, and itinerary section count.

Parameters1

status

string

optional

Filter by status (default: all)

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "all",
        "active",
        "archived",
        "planning",
        "booked",
        "completed"
      ],
      "description": "Filter by status (default: all)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

create_trip

Create a new trip (a project workspace grouping chats, searches, monitors, and bookings). Free accounts get one active trip; additional active trips require Premium.

Parameters4

name	string	required	Trip name, e.g. 'Tokyo with the family'
destination	string	optional	Primary destination (city or airport)
start_date	string	optional
end_date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Trip name, e.g. 'Tokyo with the family'"
    },
    "destination": {
      "type": "string",
      "description": "Primary destination (city or airport)"
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

delete_trip

Archive a trip, or delete it permanently. Archiving keeps the trip and its itinerary but frees the active-trip slot; bookings, monitors and chats filed under it are always kept and simply unfiled.

Parameters2

trip_id	integer	required	Trip id to remove. Use list_trips to find it.
permanently	boolean	optional	Delete the trip and its itinerary for good instead of archiving. Defaults to false.

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "integer",
      "description": "Trip id to remove. Use list_trips to find it."
    },
    "permanently": {
      "type": "boolean",
      "description": "Delete the trip and its itinerary for good instead of archiving. Defaults to false."
    }
  },
  "required": [
    "trip_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

assign_bookings_to_trip

File existing flight and/or hotel bookings under a workspace Trip so the portfolio shows them grouped as one trip. Get the trip id from list_trips / create_trip and booking ids from list_flight_bookings / list_hotel_bookings. Pass an empty array (or omit) for a booking type you're not moving.

Parameters3

trip_id	integer	required	Target workspace Trip id.
flight_booking_ids	array	optional	Flight redemption ids to file under the trip.
hotel_booking_ids	array	optional	Hotel booking ids to file under the trip.

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "integer",
      "description": "Target workspace Trip id."
    },
    "flight_booking_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Flight redemption ids to file under the trip."
    },
    "hotel_booking_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Hotel booking ids to file under the trip."
    }
  },
  "required": [
    "trip_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

update_itinerary

Write a section onto a trip's itinerary canvas — the persistent, editable trip document the agent builds. Appends a new section, or updates an existing one when section_id is given. Returns the full updated canvas. Premium tier (itinerary canvas).

Parameters5

trip_id	integer	optional	Target trip. If omitted, the user's most recent active trip is used (or a new one is created).
section_id	string	optional	Existing section id to update. Omit to append a new section.
heading	string	required	Section heading, e.g. 'Outbound flight' or 'Hotel: Tokyo'
body	string	required	Section body in markdown
kind	string	optional	Section kind (default: note)

Raw schema

{
  "type": "object",
  "properties": {
    "trip_id": {
      "type": "integer",
      "description": "Target trip. If omitted, the user's most recent active trip is used (or a new one is created)."
    },
    "section_id": {
      "type": "string",
      "description": "Existing section id to update. Omit to append a new section."
    },
    "heading": {
      "type": "string",
      "description": "Section heading, e.g. 'Outbound flight' or 'Hotel: Tokyo'"
    },
    "body": {
      "type": "string",
      "description": "Section body in markdown"
    },
    "kind": {
      "type": "string",
      "enum": [
        "flight",
        "hotel",
        "note",
        "budget"
      ],
      "description": "Section kind (default: note)"
    }
  },
  "required": [
    "heading",
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_my_documents

Search the user's OWN uploaded documents (award charts, hotel folios, itineraries, statements) and return ranked excerpts. Use when the user refers to 'my document', 'the folio/itinerary/chart I uploaded', or asks a question that should be answered from their own files rather than the public editorial archive. Returns matched excerpts with similarity scores.

Parameters2

query	string	required	Natural-language question or topic to find in the user's documents.
limit	integer	optional	How many excerpts to return (default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural-language question or topic to find in the user's documents."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many excerpts to return (default 5)."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

search_merchant_multipliers

Search a community-verified database of merchant bonus-category multipliers (e.g. 'which merchants earn 4x?', 'does Whole Foods earn a bonus on Amex Gold?'). Every entry is backed by a screenshot of the cardholder's statement as proof. Filter by merchant/card/category and a minimum multiplier. Returns verified entries with the earn rate, card, category, and a link to the proof. Free.

Parameters6

query	string	optional	Merchant, card, or category to search for (e.g. 'Whole Foods', 'Amex Gold', 'Dining'). Optional.
min_multiplier	number	optional	Only return entries earning at least this multiplier (e.g. 4 for 4x and up). Optional.
card	string	optional	Filter to a specific card by name (e.g. 'Amex Gold'). Optional.
category	string	optional	Filter to a bonus category (e.g. 'Groceries', 'Dining'). Optional.
country	string	optional	Two-letter country code to filter by (e.g. 'US', 'UK'). Optional.
limit	integer	optional	Max entries to return (default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Merchant, card, or category to search for (e.g. 'Whole Foods', 'Amex Gold', 'Dining'). Optional."
    },
    "min_multiplier": {
      "type": "number",
      "description": "Only return entries earning at least this multiplier (e.g. 4 for 4x and up). Optional."
    },
    "card": {
      "type": "string",
      "description": "Filter to a specific card by name (e.g. 'Amex Gold'). Optional."
    },
    "category": {
      "type": "string",
      "description": "Filter to a bonus category (e.g. 'Groceries', 'Dining'). Optional."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code to filter by (e.g. 'US', 'UK'). Optional."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max entries to return (default 20)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_points_valuation

Get the cents-per-point valuation for a credit-card points/miles currency or hotel program — answers "what is a Chase/Amex/Capital One/Avios/Marriott/Hyatt point worth?". Returns the headline cents-per-point, the value we've actually observed across logged redemptions (with sample size) when available, and the best way to use the currency. Pass a slug (e.g. chase-ultimate-rewards) or a loose name (e.g. "amex points", "hyatt"). Free — no account needed.

Parameters1

currency

string

required

Points/miles currency — a slug (chase-ultimate-rewards) or loose name ("amex points", "marriott", "hyatt").

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "description": "Points/miles currency — a slug (chase-ultimate-rewards) or loose name (\"amex points\", \"marriott\", \"hyatt\")."
    }
  },
  "required": [
    "currency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_cancellation_fee

Get the award-ticket cancellation/redeposit fee for an airline's OWN loyalty programme (e.g. British Airways Avios, Qatar Privilege Club, Virgin Atlantic Flying Club). Returns the headline fee, who is exempt (elite tiers), and a source link. Accepts a slug or a loose airline name. NOTE: fees for booking a carrier through a PARTNER programme differ — this returns the airline's direct policy. Free — no account needed.

Parameters1

airline

string

required

Airline slug or name, e.g. 'british-airways', 'Qatar Airways', 'virgin'.

Raw schema

{
  "type": "object",
  "properties": {
    "airline": {
      "type": "string",
      "description": "Airline slug or name, e.g. 'british-airways', 'Qatar Airways', 'virgin'."
    }
  },
  "required": [
    "airline"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_award_chart_faq

Get curated award-chart FAQs, sweet spots, and booking tips for a loyalty programme (e.g. Aeroplan, British Airways Avios, AAdvantage, Flying Blue, World of Hyatt). Use to answer questions about a programme's award pricing, best redemptions, and how to book. Accepts a programme slug OR a loose name. Returns editorial Q&A you can cite directly. Free — no account needed.

Parameters1

program

string

required

Programme slug or loose name, e.g. 'aeroplan', 'British Airways', 'avios', 'world-of-hyatt'.

Raw schema

{
  "type": "object",
  "properties": {
    "program": {
      "type": "string",
      "description": "Programme slug or loose name, e.g. 'aeroplan', 'British Airways', 'avios', 'world-of-hyatt'."
    }
  },
  "required": [
    "program"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

submit_feedback

Email a user's confirmed feedback or bug report to Award Travel Finder support. Use this when the user explicitly wants to report a bug, share feedback, request an improvement, or report an incorrect AI result. Collect a concise summary and details first; for bugs, collect reproduction steps and expected/actual behaviour when possible. Only send after the user confirms the summary, or has clearly asked you to send the complete report. Never use this for ordinary travel questions.

Parameters8

type	string	required	Whether this is general feedback or a bug report.
summary	string	required	A concise title for the feedback or bug.
details	string	required	What the user wants the Award Travel Finder team to know.
steps_to_reproduce	string	optional	For bugs, the steps that reproduce the problem, if known.
expected_behavior	string	optional	For bugs, what the user expected to happen.
actual_behavior	string	optional	For bugs, what actually happened.
page_url	string	optional	The current Award Travel Finder path or URL, when known.
confirmed	boolean	required	True only once the user has confirmed that this report should be sent.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "feedback",
        "bug"
      ],
      "description": "Whether this is general feedback or a bug report."
    },
    "summary": {
      "type": "string",
      "maxLength": 160,
      "description": "A concise title for the feedback or bug."
    },
    "details": {
      "type": "string",
      "maxLength": 4000,
      "description": "What the user wants the Award Travel Finder team to know."
    },
    "steps_to_reproduce": {
      "type": "string",
      "maxLength": 4000,
      "description": "For bugs, the steps that reproduce the problem, if known."
    },
    "expected_behavior": {
      "type": "string",
      "maxLength": 4000,
      "description": "For bugs, what the user expected to happen."
    },
    "actual_behavior": {
      "type": "string",
      "maxLength": 4000,
      "description": "For bugs, what actually happened."
    },
    "page_url": {
      "type": "string",
      "maxLength": 500,
      "description": "The current Award Travel Finder path or URL, when known."
    },
    "confirmed": {
      "type": "boolean",
      "description": "True only once the user has confirmed that this report should be sent."
    }
  },
  "required": [
    "type",
    "summary",
    "details",
    "confirmed"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

render_ui

Render a visual card in the chat instead of writing a markdown table or a long list of numbers. Use it for comparisons, cost breakdowns, transfer paths, plans, rankings, and any answer with more than ~3 numbers in it. Compose the card from blocks; every block is optional and you can repeat kinds. Block kinds: - stats — headline numbers. items: [{label, value, sub}] - table — columns: ["Program","Points"], rows: [["Aeroplan","60,000"]] - bars — visual comparison. unit: "pts", items: [{label, value (number), note}] - steps — an ordered path or plan. items: [{label, detail}] - list — rows with an optional right-hand value and link. items: [{title, subtitle, meta, value, url}] - note — a callout. tone: info|warn|success|danger, text Plain text only in every field — no markdown, no HTML. Keep your written reply to a sentence or two; the card carries the detail, so do not restate it. Do NOT call this after a search/hotel/transfer tool that already returned its own card.

Parameters3

title	string	optional	Card heading, e.g. "SFO → NRT in business".
subtitle	string	optional	One-line context under the heading.
blocks	array	required	Blocks to render, in order. Max 10.

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Card heading, e.g. \"SFO → NRT in business\"."
    },
    "subtitle": {
      "type": "string",
      "description": "One-line context under the heading."
    },
    "blocks": {
      "type": "array",
      "description": "Blocks to render, in order. Max 10.",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "stats",
              "table",
              "bars",
              "steps",
              "list",
              "note"
            ],
            "description": "Block kind."
          },
          "items": {
            "type": "array",
            "description": "Rows for stats/bars/steps/list. Objects whose keys depend on the kind.",
            "items": {
              "type": "object"
            }
          },
          "columns": {
            "type": "array",
            "description": "table: column headers.",
            "items": {
              "type": "string"
            }
          },
          "rows": {
            "type": "array",
            "description": "table: rows of cell strings.",
            "items": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "caption": {
            "type": "string",
            "description": "table: optional caption under the table."
          },
          "unit": {
            "type": "string",
            "description": "bars: unit shown after each value, e.g. \"pts\"."
          },
          "tone": {
            "type": "string",
            "enum": [
              "info",
              "warn",
              "success",
              "danger"
            ],
            "description": "note: callout tone."
          },
          "text": {
            "type": "string",
            "description": "note: the callout body."
          }
        },
        "required": [
          "kind"
        ]
      }
    }
  },
  "required": [
    "blocks"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_get_seatmap

Get the seat map for a flight from our database. Shows all seats, cabin classes, characteristics, and availability as both text and an interactive visual seatmap. Returns cached data — for fresh/updated data, use search_flight (sign in via OAuth).

Parameters2

flight_number	string	required	Flight number including airline code, e.g. 'QF1', 'AA716', 'BA178'
flight_date	string	optional	Optional flight date in YYYY-MM-DD format

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number including airline code, e.g. 'QF1', 'AA716', 'BA178'"
    },
    "flight_date": {
      "type": "string",
      "description": "Optional flight date in YYYY-MM-DD format"
    }
  },
  "required": [
    "flight_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_find_best_seats

Find the best available seats on a flight matching user preferences like window, aisle, extra legroom, exit row, quiet zone, etc. Returns a ranked list and an interactive seatmap with recommended seats highlighted.

Parameters4

flight_number	string	required	Flight number, e.g. 'QF1'
preferences	array	required	Seat preferences to match
cabin_class	string	optional	Optional cabin class filter
flight_date	string	optional	Optional flight date in YYYY-MM-DD format

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1'"
    },
    "preferences": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "window",
          "aisle",
          "extra_legroom",
          "exit_row",
          "quiet_zone",
          "front",
          "rear",
          "bulkhead"
        ]
      },
      "description": "Seat preferences to match"
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Optional cabin class filter"
    },
    "flight_date": {
      "type": "string",
      "description": "Optional flight date in YYYY-MM-DD format"
    }
  },
  "required": [
    "flight_number",
    "preferences"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_get_seat_info

Get detailed information about a specific seat on a flight, including characteristics, cabin class, availability, and pricing. Also renders the interactive seatmap.

Parameters3

flight_number	string	required	Flight number, e.g. 'QF1'
seat_number	string	required	Seat number, e.g. '12A', '1F', '32K'
flight_date	string	optional	Optional flight date in YYYY-MM-DD format

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1'"
    },
    "seat_number": {
      "type": "string",
      "description": "Seat number, e.g. '12A', '1F', '32K'"
    },
    "flight_date": {
      "type": "string",
      "description": "Optional flight date in YYYY-MM-DD format"
    }
  },
  "required": [
    "flight_number",
    "seat_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_search_flight

Search for a flight and get fresh seatmap data. Requires a signed-in account — connect this server to sign in via OAuth. Paid plan users can fetch new flights not yet in our database. Uses a search credit. Returns an interactive seatmap with the results.

Parameters2

flight_number	string	required	Flight number, e.g. 'QF1', 'AA716'
flight_date	string	optional	Flight date in YYYY-MM-DD format (defaults to today)

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1', 'AA716'"
    },
    "flight_date": {
      "type": "string",
      "description": "Flight date in YYYY-MM-DD format (defaults to today)"
    }
  },
  "required": [
    "flight_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_interactive_seat_finder

Seat finder that recommends the best seats on a flight and renders an interactive seatmap. Good default when the user wants help finding a seat but hasn't specified preferences.

Parameters2

flight_number	string	required	Flight number, e.g. 'QF1', 'AA716'
flight_date	string	optional	Optional flight date in YYYY-MM-DD format

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1', 'AA716'"
    },
    "flight_date": {
      "type": "string",
      "description": "Optional flight date in YYYY-MM-DD format"
    }
  },
  "required": [
    "flight_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_get_seat_reviews

Get user-submitted reviews for a flight, optionally filtered to a specific seat. Shows ratings, comments, seat number, cabin, and helpfulness votes. Free — no auth required.

Parameters2

flight_number	string	required	Flight number, e.g. 'QF1'
seat_number	string	optional	Optional seat number to filter reviews (e.g. '12A')

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1'"
    },
    "seat_number": {
      "type": "string",
      "description": "Optional seat number to filter reviews (e.g. '12A')"
    }
  },
  "required": [
    "flight_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_list_seat_alerts

List all your seat alerts (active and inactive). Shows which seats you're being notified about, priority, days until flight, and last check time. Requires authentication.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_create_seat_alert

Create a seat alert that notifies you by email when a matching seat becomes available on a specific flight. Supports preferences like window, aisle, exit row, specific seat, adjacent seats, and class availability. Requires authentication. The flight must already be in our database — use search_flight first if not.

Parameters6

flight_number	string	required	Flight number, e.g. 'QF1', 'AA716'
flight_date	string	required	Flight date in YYYY-MM-DD format. Must be today or within the next 60 days.
cabin_class	string	required	Cabin class to monitor
seat_preference	string	required	Seat preference to alert on
specific_seat	string	optional	Required when seat_preference is 'specific' (e.g. '12A')
adjacent_seats_count	integer	optional	Required when seat_preference is 'adjacent_seats' or 'minimum_seats' (2-9)

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "Flight number, e.g. 'QF1', 'AA716'"
    },
    "flight_date": {
      "type": "string",
      "description": "Flight date in YYYY-MM-DD format. Must be today or within the next 60 days."
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin class to monitor"
    },
    "seat_preference": {
      "type": "string",
      "enum": [
        "window",
        "aisle",
        "bulkhead",
        "exit_row",
        "extra_legroom",
        "quiet_zone",
        "front_of_cabin",
        "rear_of_cabin",
        "specific",
        "adjacent_seats",
        "minimum_seats",
        "class_availability",
        "better_seat_upgrade"
      ],
      "description": "Seat preference to alert on"
    },
    "specific_seat": {
      "type": "string",
      "description": "Required when seat_preference is 'specific' (e.g. '12A')"
    },
    "adjacent_seats_count": {
      "type": "integer",
      "minimum": 2,
      "maximum": 9,
      "description": "Required when seat_preference is 'adjacent_seats' or 'minimum_seats' (2-9)"
    }
  },
  "required": [
    "flight_number",
    "flight_date",
    "cabin_class",
    "seat_preference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_delete_seat_alert

Delete a seat alert by its ID. Use list_seat_alerts to find the alert ID. Requires authentication.

Parameters1

alert_id

integer

required

ID of the seat alert to delete

Raw schema

{
  "type": "object",
  "properties": {
    "alert_id": {
      "type": "integer",
      "description": "ID of the seat alert to delete"
    }
  },
  "required": [
    "alert_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

fs_discover_more_flight_tools

Discover other flight & travel MCP servers you can add to your client. Lists complementary remote MCPs covering award flights, airport delays/wait times, and lounges.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

sw_get_wifi_facts

Best answer for "will this flight have WiFi". Predicts the WiFi provider for a flight number on a given date, with probability, the tail number expected to operate it, aircraft type, and the airline fleet fallback. Prefer this over get_flight_wifi.

Parameters2

flight_number	string	required	IATA flight number, e.g. "UA123"
date	string	optional	Flight date in YYYY-MM-DD format. Defaults to today.

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "IATA flight number, e.g. \"UA123\""
    },
    "date": {
      "type": "string",
      "description": "Flight date in YYYY-MM-DD format. Defaults to today."
    }
  },
  "required": [
    "flight_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_get_flight_wifi

Shorter WiFi lookup for a flight number: provider, confidence, airline, aircraft, and Starlink status. Use get_wifi_facts instead when you need the date, tail number, or reasoning.

Parameters1

flight_number

string

required

IATA flight number, e.g. "UA123" or "DL456"

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "IATA flight number, e.g. \"UA123\" or \"DL456\""
    }
  },
  "required": [
    "flight_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_get_airline_wifi

WiFi providers an airline uses fleet-wide, plus a fleet summary and whether WiFi is free. Use when the question is about the airline rather than one flight.

Parameters1

airline_code

string

required

IATA airline code, e.g. "UA" for United, "DL" for Delta

Raw schema

{
  "type": "object",
  "properties": {
    "airline_code": {
      "type": "string",
      "description": "IATA airline code, e.g. \"UA\" for United, \"DL\" for Delta"
    }
  },
  "required": [
    "airline_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_get_rollouts

Starlink and satellite WiFi rollout progress per aircraft type: status (complete, in_progress, planned, announced), fleet percentage, and expected completion. Omit airline_code for every tracked airline.

Parameters1

airline_code

string

optional

Optional IATA airline code to filter rollouts, e.g. "UA"

Raw schema

{
  "type": "object",
  "properties": {
    "airline_code": {
      "type": "string",
      "description": "Optional IATA airline code to filter rollouts, e.g. \"UA\""
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_get_speed_stats

Crowd-sourced in-flight WiFi speed reports: average download/upload Mbps, latency, and a per-provider breakdown. Use for "is the WiFi fast enough" questions. Pass a flight_number or an airline_code, not both.

Parameters2

flight_number	string	optional	IATA flight number, e.g. "UA123"
airline_code	string	optional	IATA airline code, e.g. "UA"

Raw schema

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "description": "IATA flight number, e.g. \"UA123\""
    },
    "airline_code": {
      "type": "string",
      "description": "IATA airline code, e.g. \"UA\""
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_get_tail_info

WiFi provider history for one aircraft by tail number, including crowd-sourced reports and fleet assignment. Use when the exact airframe is known.

Parameters1

tail_number

string

required

Aircraft registration / tail number, e.g. "N12345"

Raw schema

{
  "type": "object",
  "properties": {
    "tail_number": {
      "type": "string",
      "description": "Aircraft registration / tail number, e.g. \"N12345\""
    }
  },
  "required": [
    "tail_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_search_wifi

Free-text search across airlines and flights when you only have a name or partial term. Use a specific tool instead when you already have a flight number, airline code, or tail number.

Parameters1

query

string

required

Search query, e.g. "United" or "UA123"

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query, e.g. \"United\" or \"UA123\""
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sw_list_airlines

Every airline SeatWiFi tracks, with its WiFi providers. Large response — use search_wifi or get_airline_wifi when you know which airline you want.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_search_lounges

Search airport lounges worldwide by name, airport name, IATA code, city, or country. Returns matching lounges with amenities, access methods, and ratings. Use this to find specific lounges or discover lounges in a location.

Parameters1

query

string

required

Search query (lounge name, airport name, IATA code, city, or country)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Search query (lounge name, airport name, IATA code, city, or country)"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_airport_lounges

Get all airport lounges at a specific airport by IATA code. Returns every lounge at the airport with terminal location, amenities, access methods, and ratings.

Parameters1

iata

string

required

Airport IATA code (e.g. LHR, JFK, SIN)

Raw schema

{
  "type": "object",
  "properties": {
    "iata": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Airport IATA code (e.g. LHR, JFK, SIN)"
    }
  },
  "required": [
    "iata"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_lounge_details

Get detailed information about a specific airport lounge by its slug. Returns full description, amenities, access methods, opening hours, capacity, ratings, and reviews count.

Parameters1

slug

string

required

Lounge slug (from search results or airport lounges)

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Lounge slug (from search results or airport lounges)"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_find_lounges_by_access

Find all airport lounges accessible with a specific credit card, membership program, airline club, alliance status, or ticket class. For example, find all lounges you can access with your Amex Platinum or Priority Pass membership.

Parameters1

access_method

string

required

Access method slug (e.g. amex-platinum, priority-pass, chase-sapphire-reserve, business-class, star-alliance-gold)

Raw schema

{
  "type": "object",
  "properties": {
    "access_method": {
      "type": "string",
      "enum": [
        "amex-platinum",
        "chase-sapphire-reserve",
        "capital-one-venture-x",
        "citi-prestige",
        "amex-centurion",
        "hilton-aspire",
        "marriott-brilliant",
        "ritz-carlton",
        "bilt-mastercard",
        "priority-pass",
        "loungekey",
        "dragonpass",
        "diners-club",
        "plaza-premium",
        "business-class",
        "first-class",
        "united-club",
        "delta-sky-club",
        "admirals-club",
        "qantas-club",
        "star-alliance",
        "oneworld",
        "skyteam",
        "star-alliance-gold",
        "oneworld-emerald",
        "oneworld-sapphire",
        "skyteam-elite-plus"
      ],
      "description": "Access method slug (e.g. amex-platinum, priority-pass, chase-sapphire-reserve, business-class, star-alliance-gold)"
    }
  },
  "required": [
    "access_method"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_list_access_methods

List all available lounge access methods including credit cards (Amex Platinum, Chase Sapphire Reserve, etc.), membership programs (Priority Pass, LoungeKey, etc.), airline clubs, alliance status levels, and ticket classes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_list_networks

List all lounge networks (Priority Pass, LoungeKey, DragonPass, Plaza Premium, Amex Centurion) with their descriptions and total lounge counts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_network_lounges

Get all lounges in a specific lounge network. Returns every lounge that accepts a particular network membership (e.g. all Priority Pass lounges worldwide).

Parameters1

network

string

required

Network slug (priority-pass, loungekey, dragonpass, plaza-premium, amex-centurion)

Raw schema

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "enum": [
        "priority-pass",
        "loungekey",
        "dragonpass",
        "plaza-premium",
        "amex-centurion"
      ],
      "description": "Network slug (priority-pass, loungekey, dragonpass, plaza-premium, amex-centurion)"
    }
  },
  "required": [
    "network"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_discover_more_flight_tools

Discover other flight & travel MCP servers you can add to your client. Lists complementary remote MCPs covering award flights/points redemptions, aircraft seatmaps, and airport delays/wait times — with one-line install URLs. Call this when the user asks about points/miles, seat selection, airport delays/security waits, or 'what other flight tools are there?'

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_my_profile

Get your Airport Lounge List profile — username, stats (reviews, visits, wishlisted lounges), and recent activity.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_my_passport

Get your lounge passport — stats (lounges visited, airports, countries, reviews), country stamps, full visit history, and your reviews. Includes a shareable passport URL when your profile is public.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_my_reviews

Get your lounge reviews, including pending ones. Returns rating, content, approval status, and lounge info.

Parameters1

limit

integer

optional

Max reviews to return (default 20, max 50)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max reviews to return (default 20, max 50)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_write_review

Write a review for a lounge. Requires the lounge slug, a rating (1-5), and review text (min 10 characters).

Parameters3

lounge_slug	string	required	Lounge slug (from search results)
rating	integer	required	Rating from 1 (poor) to 5 (excellent)
content	string	required	Review text (minimum 10 characters)

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug (from search results)"
    },
    "rating": {
      "type": "integer",
      "description": "Rating from 1 (poor) to 5 (excellent)",
      "minimum": 1,
      "maximum": 5
    },
    "content": {
      "type": "string",
      "description": "Review text (minimum 10 characters)",
      "minLength": 10
    }
  },
  "required": [
    "lounge_slug",
    "rating",
    "content"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_update_review

Update your review of a lounge — change the rating and/or the text. Identify the review by lounge_slug.

Parameters3

lounge_slug	string	required	Lounge slug of the review to update
rating	integer	optional	New rating, 1-5
content	string	optional	New review text (minimum 10 characters)

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug of the review to update"
    },
    "rating": {
      "type": "integer",
      "description": "New rating, 1-5",
      "minimum": 1,
      "maximum": 5
    },
    "content": {
      "type": "string",
      "description": "New review text (minimum 10 characters)",
      "minLength": 10
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_delete_review

Delete your review of a lounge. Identify it by lounge_slug.

Parameters1

lounge_slug

string

required

Lounge slug of the review to delete

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug of the review to delete"
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_my_visits

Get your visited lounges list with dates and notes.

Parameters1

limit

integer

optional

Max visits to return (default 20, max 50)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max visits to return (default 20, max 50)"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_mark_lounge_visited

Log a lounge visit (check in). Identify the lounge by its slug OR by lounge_name + airport_iata. Optionally add a 1-5 rating and notes. Idempotent: logging the same lounge on the same date updates the existing visit's rating/notes instead of creating a duplicate.

Parameters6

lounge_slug	string	optional	Lounge slug (from search results). Preferred if known.
lounge_name	string	optional	Lounge name — use with airport_iata if you don't have the slug.
airport_iata	string	optional	3-letter airport IATA code — use with lounge_name.
visited_at	string	required	Date of visit (YYYY-MM-DD)
rating	integer	optional	Your rating, 1 (poor) to 5 (excellent)
notes	string	optional	Optional notes about your visit

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug (from search results). Preferred if known."
    },
    "lounge_name": {
      "type": "string",
      "description": "Lounge name — use with airport_iata if you don't have the slug."
    },
    "airport_iata": {
      "type": "string",
      "description": "3-letter airport IATA code — use with lounge_name."
    },
    "visited_at": {
      "type": "string",
      "format": "date",
      "description": "Date of visit (YYYY-MM-DD)"
    },
    "rating": {
      "type": "integer",
      "description": "Your rating, 1 (poor) to 5 (excellent)",
      "minimum": 1,
      "maximum": 5
    },
    "notes": {
      "type": "string",
      "description": "Optional notes about your visit"
    }
  },
  "required": [
    "visited_at"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_update_visit

Update one of your logged lounge visits — change the rating, notes, or date. Identify the visit by lounge_slug; if you have multiple visits to the same lounge, pass visited_at to pick the one to update.

Parameters5

lounge_slug	string	required	Lounge slug of the visit to update
visited_at	string	optional	Existing visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits
rating	integer	optional	New rating, 1-5
notes	string	optional	New notes
new_visited_at	string	optional	Change the visit date to this (YYYY-MM-DD)

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug of the visit to update"
    },
    "visited_at": {
      "type": "string",
      "format": "date",
      "description": "Existing visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits"
    },
    "rating": {
      "type": "integer",
      "description": "New rating, 1-5",
      "minimum": 1,
      "maximum": 5
    },
    "notes": {
      "type": "string",
      "description": "New notes"
    },
    "new_visited_at": {
      "type": "string",
      "format": "date",
      "description": "Change the visit date to this (YYYY-MM-DD)"
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_delete_visit

Delete one of your logged lounge visits. Identify it by lounge_slug; pass visited_at to pick a specific date if you have multiple visits to the same lounge.

Parameters2

lounge_slug	string	required	Lounge slug of the visit to delete
visited_at	string	optional	Visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug of the visit to delete"
    },
    "visited_at": {
      "type": "string",
      "format": "date",
      "description": "Visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits"
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_get_my_wishlist

Get your lounge wishlist — lounges you want to visit.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_add_to_wishlist

Add a lounge to your wishlist. Idempotent — adding a lounge already on your wishlist is a no-op.

Parameters1

lounge_slug

string

required

Lounge slug (from search results)

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug (from search results)"
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

lounge_remove_from_wishlist

Remove a lounge from your wishlist.

Parameters1

lounge_slug

string

required

Lounge slug (from search results)

Raw schema

{
  "type": "object",
  "properties": {
    "lounge_slug": {
      "type": "string",
      "description": "Lounge slug (from search results)"
    }
  },
  "required": [
    "lounge_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_list_cards

List credit cards in the database. Returns compact summaries (id, fees, welcome bonus value, top multipliers). Use get_card for full details.

Parameters3

provider	string	optional	Filter by issuer.
region	string	optional	Filter by region/country.
card_type	string	optional	Filter by personal vs business.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "amex",
        "chase",
        "bilt",
        "capital-one",
        "anz",
        "nab",
        "westpac",
        "cba",
        "barclaycard",
        "hsbc",
        "virgin-money",
        "lloyds",
        "currensea",
        "yonder",
        "other"
      ],
      "description": "Filter by issuer."
    },
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ],
      "description": "Filter by region/country."
    },
    "card_type": {
      "type": "string",
      "enum": [
        "personal",
        "business"
      ],
      "description": "Filter by personal vs business."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_get_card

Get full details for a single card, including all multipliers, all benefits, welcome bonus, and source URL.

Parameters1

string

required

Card id, e.g. "amex-gold-us". Use list_cards to discover ids.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Card id, e.g. \"amex-gold-us\". Use list_cards to discover ids."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_compare_cards

Compare 2–4 cards side by side: annual fees, welcome bonuses, top multipliers, and total benefit credits. Pass card ids from list_cards.

Parameters1

ids

array

required

Card ids to compare, e.g. ["amex-gold-us", "chase-sapphire-preferred"].

Raw schema

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 4,
      "description": "Card ids to compare, e.g. [\"amex-gold-us\", \"chase-sapphire-preferred\"]."
    }
  },
  "required": [
    "ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_find_cards_for_category

Find cards with the best earning multiplier for a spend category (e.g. "dining", "groceries", "petrol", "travel"). Returns cards sorted by multiplier descending.

Parameters5

category	string	required	Spend category — supports UK/AU terms like "petrol", "chemist", "woolworths".
region	string	optional
card_type	string	optional
min_multiplier	number	optional	Only return cards at or above this multiplier.
limit	number	optional	Max results (default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Spend category — supports UK/AU terms like \"petrol\", \"chemist\", \"woolworths\"."
    },
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ]
    },
    "card_type": {
      "type": "string",
      "enum": [
        "personal",
        "business"
      ]
    },
    "min_multiplier": {
      "type": "number",
      "description": "Only return cards at or above this multiplier."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 10)."
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_rank_welcome_bonuses

List current welcome bonuses sorted by point/mile value descending. Optionally filter by spend achievability.

Parameters5

region	string	optional
card_type	string	optional
monthly_spend	number	optional	Monthly spend in the card's local currency. If provided, only includes bonuses where required spend ≤ monthly_spend × months.
min_value	number	optional	Minimum bonus point/mile value.
limit	number	optional	Max results (default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ]
    },
    "card_type": {
      "type": "string",
      "enum": [
        "personal",
        "business"
      ]
    },
    "monthly_spend": {
      "type": "number",
      "description": "Monthly spend in the card's local currency. If provided, only includes bonuses where required spend ≤ monthly_spend × months."
    },
    "min_value": {
      "type": "number",
      "description": "Minimum bonus point/mile value."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 20)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_analyze_spending

Given a breakdown of the user's monthly spending, estimate annual rewards for each card and rank them. Includes net annual fee after benefit credits.

Parameters4

monthly_spending	array	required	Array of {category, amount} for the user's typical monthly spend. Amounts in the local currency of the chosen region.
region	string	optional	Region of cards to evaluate. Defaults to US.
card_type	string	optional
limit	number	optional	Max cards to return (default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "monthly_spending": {
      "type": "array",
      "description": "Array of {category, amount} for the user's typical monthly spend. Amounts in the local currency of the chosen region.",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          }
        },
        "required": [
          "category",
          "amount"
        ]
      }
    },
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ],
      "description": "Region of cards to evaluate. Defaults to US."
    },
    "card_type": {
      "type": "string",
      "enum": [
        "personal",
        "business"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Max cards to return (default 10)."
    }
  },
  "required": [
    "monthly_spending"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_list_changes

List recent card data changes (welcome bonus updates, fee changes, multiplier edits). Useful for "what changed recently?" queries.

Parameters3

card_id	string	optional	Filter to changes for one card.
days	number	optional	Look back this many days (default 30).
limit	number	optional	Max results (default 50).

Raw schema

{
  "type": "object",
  "properties": {
    "card_id": {
      "type": "string",
      "description": "Filter to changes for one card."
    },
    "days": {
      "type": "number",
      "description": "Look back this many days (default 30)."
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 50)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_list_transfer_partners

List transferable points programs and their airline/hotel partners. Region filter shows programs relevant to that market (e.g. region=UK shows UK Amex MR, Barclaycard, HSBC).

Parameters3

provider	string	optional	Filter to one provider, e.g. "amex" or "anz".
partner_type	string	optional
region	string	optional	Filter to programs from a specific region.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "description": "Filter to one provider, e.g. \"amex\" or \"anz\"."
    },
    "partner_type": {
      "type": "string",
      "enum": [
        "airline",
        "hotel"
      ]
    },
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ],
      "description": "Filter to programs from a specific region."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

cards_find_transfer_programs_for_airline

Find which transferable points programs can transfer to a given airline or hotel. Optionally filter by region to see locally relevant programs.

Parameters2

partner_name	string	required	Airline or hotel name, e.g. "Qantas", "Virgin Atlantic", "Hyatt".
region	string	optional	Filter to programs from a specific region.

Raw schema

{
  "type": "object",
  "properties": {
    "partner_name": {
      "type": "string",
      "description": "Airline or hotel name, e.g. \"Qantas\", \"Virgin Atlantic\", \"Hyatt\"."
    },
    "region": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "AU",
        "DE",
        "FR",
        "IT",
        "ES",
        "NL"
      ],
      "description": "Filter to programs from a specific region."
    }
  },
  "required": [
    "partner_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

viator_get_experience_details

Retrieves enriched information for a specific Viator experience, including detailed descriptions, highlights, imagery, pricing, duration, key features, and the click-out URL.The model should call this tool only when the user clearly refers to a specific experience—either by selecting it in the UI or by asking follow-up questions such as “Tell me more about…”;if multiple experiences were shown, the model must resolve ambiguity by asking which one the user means. This tool is intended for deepening experience understanding rather than search, and should only be invoked with a code previously returned by search_experiences.

Parameters5

code	string	required	(required) Unique identifier of the Viator experience to retrieve details for.This value must correspond to an experience previously returned by the search_experiences tool.The model must not guess or make up experience IDs; if the user request is ambiguous (e.g., multiple items shown), the model must ask which experience they mean before calling the tool.
language	string	optional	(deprecated) This value is deprecated and should not be sent. Please only send the locale.
locale	string	optional	(optional) The language/locale code requested for content localization (e.g., en-US, en-GB, fr-FR).If not provided by the user, the model should infer it from context or default to en.Used to descriptions, highlights, and content where available.
currency	string	optional	(optional) Currency code for from-price display (e.g., USD, EUR, GBP).When provided, fromPrice and fromPriceBeforeDiscount are populated.When omitted, pricing fields are not returned.Should match the currency used in the preceding search_experiences call when available.
sessionId	string	required	(mandatory) A unique identifier, ideally an UUID, for the current user conversation. The same identifier should be used until the user opens a new chat.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "(required) Unique identifier of the Viator experience to retrieve details for.This value must correspond to an experience previously returned by the search_experiences tool.The model must not guess or make up experience IDs; if the user request is ambiguous (e.g., multiple items shown), the model must ask which experience they mean before calling the tool."
    },
    "language": {
      "type": "string",
      "description": "(deprecated) This value is deprecated and should not be sent. Please only send the locale."
    },
    "locale": {
      "type": "string",
      "description": "(optional) The language/locale code requested for content localization (e.g., en-US, en-GB, fr-FR).If not provided by the user, the model should infer it from context or default to en.Used to descriptions, highlights, and content where available."
    },
    "currency": {
      "type": "string",
      "description": "(optional) Currency code for from-price display (e.g., USD, EUR, GBP).When provided, fromPrice and fromPriceBeforeDiscount are populated.When omitted, pricing fields are not returned.Should match the currency used in the preceding search_experiences call when available."
    },
    "sessionId": {
      "type": "string",
      "description": "(mandatory) A unique identifier, ideally an UUID, for the current user conversation. The same identifier should be used until the user opens a new chat."
    }
  },
  "required": [
    "code",
    "sessionId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

viator_search_experiences

Retrieves a curated list of Viator experiences based on a free-text search of what the user wants (destination, activity type, and preferences), plus trip dates and optional refiners (budget, duration, etc.). The model must supply a non-blank searchTerm as natural language describing where and what the user is looking for (e.g. "walking tours in Paris, France", "kid friendly food experiences in Rome"). Dates, prices, duration limits, and currency belong in their dedicated parameters—not inside searchTerm. The model must provide searchTerm and dates before calling this tool. The model may re-issue a refined searchExperiences call whenever the user adds, removes, or adjusts refinement criteria (e.g., kid-friendly, price range, shorter duration) to narrow or improve the results. If the tool returns zero results, the model must proactively guide the user toward a successful refinement. It should review the parameters used in the failed request and recommend the most appropriate based on the proposed logic:" If >

Parameters10

searchTerm	string	required	(required) Natural-language description of what the user is looking for. Must be non-blank; the tool rejects empty or whitespace-only values. Include destination, activity type, and preferences in this single free-text query (e.g. 'walking tours in Paris, France'). Do not embed dates, prices, duration limits, or currency here—use the dedicated fields.
startDate	string	required	(required) The first date the user is available to participate in an experience, formatted as ISO-8601 (YYYY-MM-DD).The model must convert natural-language expressions (e.g., 'this summer', 'next weekend', 'early April', 'tomorrow') into a specific ISO date before calling the tool. When resolving these expressions, if searchTerm names a destination, use that location's local timezone. Otherwise, use the user's current timezone. The date must not be in the past. Must be before the endDate.
endDate	string	required	(required) The last date the user is available to participate in an experience, formatted as ISO-8601 (YYYY-MM-DD).Also derived from natural-language expressions (e.g., 'this summer', 'next weekend', 'early April', 'tomorrow'); if the user gives a single day, set endDate = startDate. When resolving these expressions, use the destination timezone from searchTerm when inferable, otherwise the user's timezone. Must be >= startDate. Used to widen search results to a date range.
duration	integer	optional	(optional) User preference for maximum experience length, expressed in minutes.Used to filter results to experiences at or below this duration.
fromPrice	number	optional	(optional) Minimum per-person price to include in search, expressed in the requested currency.Used when the user specifies a lower budget boundary (e.g., “at least €50”).
toPrice	number	optional	(optional) Maximum per-person price to include in search, expressed in the requested currency.Used when the user expresses a maximum budget (e.g., “under $100”)
currency	string	optional	(optional) Currency code used for interpreting and filtering prices.The model should infer currency from context when possible (e.g., GBP if the user is in the UK; USD if the user specifies dollars).Default value: USDValid ISO currency codes include: AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, FJD, GBP, HKD, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR
limit	integer	optional	(optional) Maximum number of products to return, between 1 and 10.If omitted, defaults to 5.Not intended as a user-facing refinement mechanism; the model should not use it to alter intent.
locale	string	optional	(optional) The language/locale code requested for content localization (e.g., en-US, en-GB, fr-FR).If not provided by the user, the model should infer it from context or default to en.Used to localize title, and other content where available.
sessionId	string	required	(mandatory) A unique identifier, ideally an UUID, for the current user conversation. The same identifier should be used until the user opens a new chat.

Raw schema

{
  "type": "object",
  "properties": {
    "searchTerm": {
      "type": "string",
      "description": "(required) Natural-language description of what the user is looking for. Must be non-blank; the tool rejects empty or whitespace-only values. Include destination, activity type, and preferences in this single free-text query (e.g. 'walking tours in Paris, France'). Do not embed dates, prices, duration limits, or currency here—use the dedicated fields."
    },
    "startDate": {
      "type": "string",
      "description": "(required) The first date the user is available to participate in an experience, formatted as ISO-8601 (YYYY-MM-DD).The model must convert natural-language expressions (e.g., 'this summer', 'next weekend', 'early April', 'tomorrow') into a specific ISO date before calling the tool. When resolving these expressions, if searchTerm names a destination, use that location's local timezone. Otherwise, use the user's current timezone. The date must not be in the past. Must be before the endDate."
    },
    "endDate": {
      "type": "string",
      "description": "(required) The last date the user is available to participate in an experience, formatted as ISO-8601 (YYYY-MM-DD).Also derived from natural-language expressions (e.g., 'this summer', 'next weekend', 'early April', 'tomorrow'); if the user gives a single day, set endDate = startDate. When resolving these expressions, use the destination timezone from searchTerm when inferable, otherwise the user's timezone. Must be >= startDate. Used to widen search results to a date range."
    },
    "duration": {
      "type": "integer",
      "format": "int32",
      "description": "(optional) User preference for maximum experience length, expressed in minutes.Used to filter results to experiences at or below this duration."
    },
    "fromPrice": {
      "type": "number",
      "description": "(optional) Minimum per-person price to include in search, expressed in the requested currency.Used when the user specifies a lower budget boundary (e.g., “at least €50”)."
    },
    "toPrice": {
      "type": "number",
      "description": "(optional) Maximum per-person price to include in search, expressed in the requested currency.Used when the user expresses a maximum budget (e.g., “under $100”)"
    },
    "currency": {
      "type": "string",
      "description": "(optional) Currency code used for interpreting and filtering prices.The model should infer currency from context when possible (e.g., GBP if the user is in the UK; USD if the user specifies dollars).Default value: USDValid ISO currency codes include: AED, ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, FJD, GBP, HKD, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PEN, PHP, PLN, SEK, SGD, THB, TRY, TWD, USD, VND, ZAR"
    },
    "limit": {
      "type": "integer",
      "format": "int32",
      "description": "(optional) Maximum number of products to return, between 1 and 10.If omitted, defaults to 5.Not intended as a user-facing refinement mechanism; the model should not use it to alter intent."
    },
    "locale": {
      "type": "string",
      "description": "(optional) The language/locale code requested for content localization (e.g., en-US, en-GB, fr-FR).If not provided by the user, the model should infer it from context or default to en.Used to localize title, and other content where available."
    },
    "sessionId": {
      "type": "string",
      "description": "(mandatory) A unique identifier, ideally an UUID, for the current user conversation. The same identifier should be used until the user opens a new chat."
    }
  },
  "required": [
    "searchTerm",
    "startDate",
    "endDate",
    "sessionId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

README.md6 KBView on GitHub

Award Travel Finder — Claude Code Plugin & MCP Server

Search award flight availability, compare loyalty programs, and find the best points redemptions from your AI assistant. This plugin connects to the Award Travel Finder MCP server, which exposes 127 award-travel tools over a single hosted endpoint.

Works with Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT, Grok, Antigravity, and any MCP-compatible client.

Quick install

Claude Code plugin (recommended)

code

/plugin marketplace add AwardTravelFinder/mcp
/plugin install award-travel-finder

Gemini CLI / Antigravity

code

gemini extensions install https://github.com/AwardTravelFinder/mcp

Any other MCP client

Point your client at the endpoint:

code

https://mcp.awardtravelfinder.com/mcp

For clients that take a config file:

json

{
  "mcpServers": {
    "awardtravelfinder": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.awardtravelfinder.com/mcp"]
    }
  }
}

Clients with native remote-MCP support (Cursor, Windsurf, ChatGPT developer mode, Grok custom connectors) can use the URL directly without mcp-remote.

Per-client setup guides: awardtravelfinder.com/mcp.

Authentication

The server uses OAuth 2.1 as the MCP spec describes. On your first tool call the client opens your browser to sign in — about 30 seconds, no card. There is no API key.

Do not set an Authorization or X-API-Key header. API-key authentication was retired on 2026-06-07. A leftover static header overrides the OAuth token the client obtained, and every request then fails with 401 even though the sign-in appeared to succeed. If you followed an older version of these instructions, delete the headers block from your config.

A free account covers everyday trip planning. Premium unlocks unlimited searches and every cabin.

What you can do

Ask naturally — the bundled award-travel skill activates on its own when you mention award flights, points, miles, or an airline:

code

"Find business class from London to New York using Avios"
"Are there any award seats on Cathay Pacific HKG-LHR next month?"
"Which program has the cheapest business class to Tokyo?"
"How many Avios do I need for London to New York in business?"

Or use the slash commands:

code

/atf:search-flights BA LHR JFK 2026-06-15
/atf:compare-programs british-airways emirates

Coverage

28 airlines can be searched one at a time with search_availability:

British Airways, Qatar Airways, Cathay Pacific, Virgin Atlantic, Iberia, Emirates, Qantas, Alaska Airlines, American Airlines, JetBlue, Frontier, Southwest, Delta, Japan Airlines, United, TAP Portugal, Cape Air, Icelandair, Condor, Aer Lingus, El Al, Turkish Airlines, ANA, Lufthansa, Air France, KLM, Etihad, Smiles (GOL).

11 of those are in the search_all_airlines fan-out, which sweeps them together in one call: British Airways, Cathay Pacific, Virgin Atlantic, Iberia, Qatar Airways, Alaska Airlines, JetBlue, Frontier, Southwest, Qantas, Smiles (GOL). Award inventory is genuinely sparse, so a route with no results usually means no seats rather than a broken search.

23 loyalty programs have award-chart data via get_program_rates:

british-airways, qatar-airways, singapore-airlines, cathay-pacific, emirates, etihad, flying-blue, aeroplan, turkish-airlines, ana, jetblue, jet2-emirates, virgin-atlantic, iberia, alaska-airlines, american-airlines, qantas, delta-skymiles, united, lifemiles, marriott-bonvoy, hilton-honors, hyatt.

4 hotel programs for award nights: Marriott, Hilton, IHG, Hyatt.

Tools

127 tools in total. The most-used ones:

Tool	What it does
`search_availability`	Award seats for one airline, route and date
`search_all_airlines`	Sweep the 9 fan-out airlines in one call
`search_monthly_availability`	A whole month, day by day
`search_hybrid`	Cash-and-points combinations
`get_pricing`	Award-chart pricing for a route
`get_program_rates`	The full award chart for a program
`get_points_valuation`	What a currency is worth
`find_transfer_paths`	Routes from your cards into a program
`compare_transfer_options`	Which transfer gets you there cheapest
`get_status_matches`	Elite status match opportunities
`search_hotels` / `get_hotel_availability`	Award nights across the 4 hotel programs
`get_portfolio` / `list_points_balances`	Your tracked balances
`add_flight_booking` / `list_flight_bookings`	Your trip log

Run tools/list against the endpoint for the full catalogue — it answers without authentication, so you can inspect the server before signing in.

Repository structure

This repo is the public home for every Award Travel Finder AI and MCP surface — the Claude Code plugin, the MCP server manifest we publish to the official registry, and the metadata directories index.

code

mcp/
  server.json            # Official MCP registry manifest
  gemini-extension.json  # Gemini CLI / Antigravity extension manifest
  .claude-plugin/
    plugin.json          # Plugin metadata
    marketplace.json     # Marketplace listing
  .mcp.json              # MCP server connection config
  logo.png               # 400x400 marketplace logo
  llms-install.md        # Agent-readable setup steps
  commands/
    search-flights.md    # /atf:search-flights
    compare-programs.md  # /atf:compare-programs
  skills/
    award-travel/        # Activates on award-travel questions
  openclaw/
    SKILL.md             # OpenClaw-flavoured variant of the same skill

The MCP server itself is a hosted service at mcp.awardtravelfinder.com; this repo holds the manifests and client-facing docs, not the server implementation.

Support

Open an issue here, or email support@awardtravelfinder.com.

License

MIT

Install

Tools (136)

search_all_airlinessearch_availabilitysearch_monthly_availabilityget_pricingsearch_hybridget_award_trip_detailsget_program_ratesget_buy_points_pricing

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.awardtravelfinder.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.awardtravelfinder.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.