Servidor MCP
Award Travel Finder
com.awardtravelfinder/mcp
Qué hace este MCP
Searches award flights and hotels, tracks bookings and loyalty balances, evaluates points and credit cards, and monitors travel redemptions.
Capacidades
Herramientas
137
herramientas
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline', 'origin', 'destination', 'departure_date', 'cabin_class'], 'properties': {'kind': {'enum': ['award', 'cash'], 'type': 'string', 'description': 'award = points/miles redemption (default); cash = paid with money. Defaults to award.'}, 'notes': {'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'airline': {'type': 'string'}, 'program': {'type': 'string', 'description': 'Award bookings only. Loyalty program used.'}, '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.'}, 'cash_paid': {'type': 'number', 'minimum': 0, 'description': 'Cash bookings only. Total cash fare paid for this leg, in taxes_currency (default USD).'}, 'passengers': {'type': 'integer', 'minimum': 1}, 'taxes_paid': {'type': 'number'}, 'cabin_class': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'return_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, '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.'}, 'flight_number': {'type': 'string'}, 'departure_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'taxes_currency': {'type': 'string', 'description': 'Currency for taxes_paid and cash_paid. Defaults to USD.'}, '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.'}, 'confirmation_number': {'type': 'string'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['hotel_id', 'check_in_date', 'check_out_date'], 'properties': {'kind': {'enum': ['award', 'cash'], 'type': 'string', 'description': 'award = points stay with price-drop monitoring (default); cash = paid with money. Defaults to award.'}, 'notes': {'type': 'string'}, 'trip_id': {'type': 'integer', 'description': 'Optional id of a workspace Trip (from create_trip / list_trips) to file this stay under.'}, 'hotel_id': {'type': 'string', 'description': 'Hotel identifier from search_hotels / get_hotel_availability results.'}, 'rate_plan': {'type': 'string'}, 'room_type': {'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}$'}, 'original_points': {'type': 'integer', 'minimum': 1, 'description': 'Award bookings only. Total points paid for the stay.'}, 'cash_rate_currency': {'type': 'string', 'description': 'Currency of original_pay_rate_usd. Defaults to USD.'}, 'confirmation_number': {'type': 'string'}, '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).'}}}
add_voucher
Add a companion/upgrade voucher the user holds to their inventory. Use list_voucher_types to find the voucher_slug. Paid feature.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['voucher_slug'], 'properties': {'notes': {'type': 'string'}, 'reference': {'type': 'string', 'description': 'Voucher code or membership reference.'}, 'expires_on': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Voucher expiry date (YYYY-MM-DD).'}, 'voucher_slug': {'type': 'string', 'description': "Slug from list_voucher_types, e.g. 'ba-amex-premium-plus-companion'."}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['voucher_id'], 'properties': {'booking_id': {'type': 'integer', 'minimum': 1, 'description': 'ID of the booking to apply the voucher to. Omit to detach.'}, 'voucher_id': {'type': 'integer', 'minimum': 1, 'description': "ID of the user's voucher (from list_my_vouchers)."}, 'booking_type': {'enum': ['flight', 'hotel'], 'type': 'string', 'description': 'Whether booking_id refers to a flight redemption or a hotel booking.'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['trip_id'], 'properties': {'trip_id': {'type': 'integer', 'description': 'Target workspace Trip id.'}, 'hotel_booking_ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Hotel booking ids to file under the trip.'}, 'flight_booking_ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Flight redemption ids to file under the trip.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['chain', 'folio_text'], 'properties': {'chain': {'enum': ['marriott', 'hilton', 'hyatt', 'ihg'], 'type': 'string'}, 'stay_type': {'enum': ['award', 'cash', 'points_advance'], 'type': 'string'}, 'folio_text': {'type': 'string'}, 'status_tier': {'type': 'string'}, 'confirmation_number': {'type': 'string'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['folio_text'], 'properties': {'stay_type': {'enum': ['award', 'cash', 'points_advance'], 'type': 'string'}, 'folio_text': {'type': 'string'}, 'status_tier': {'enum': ['member', 'silver', 'gold', 'platinum', 'titanium', 'ambassador'], 'type': 'string'}, 'confirmation_number': {'type': 'string'}}}
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'.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'program'], 'properties': {'cabin': {'type': 'string', 'default': 'economy', 'description': 'Cabin: economy, premium, business, or first.'}, 'origin': {'type': 'string', 'description': "Origin airport IATA code, e.g. 'LHR'."}, 'program': {'type': 'string', 'description': "Qualifying program slug: 'british-airways-executive-club', 'air-france-klm-flying-blue', or 'american-aadvantage'."}, 'segments': {'type': 'integer', 'minimum': 1, 'description': 'Number of flight segments/legs (multiplies Flying Blue XP). Default 1.'}, 'fare_price': {'type': 'number', 'description': 'Fare price for revenue-based programs (BA Tier Points, AA Loyalty Points). Base fare + carrier surcharges, excluding taxes.'}, 'destination': {'type': 'string', 'description': "Destination airport IATA code, e.g. 'JFK'."}, 'fare_currency': {'type': 'string', 'description': "ISO currency of fare_price (e.g. GBP, USD, EUR). Defaults to the program's home currency."}}}
cancel_route_monitor
Cancel an active route monitor by ID. Cancelled monitors stop firing but are preserved for history.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['monitor_id'], 'properties': {'monitor_id': {'type': 'integer'}}}
cancel_standing_order
Stop a standing order by ID so it no longer runs. The record is kept, including its last result.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['standing_order_id'], 'properties': {'standing_order_id': {'type': 'integer'}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['monthly_spending'], 'properties': {'limit': {'type': 'number', 'description': 'Max cards to return (default 10).'}, 'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string', 'description': 'Region of cards to evaluate. Defaults to US.'}, 'card_type': {'enum': ['personal', 'business'], 'type': 'string'}, 'monthly_spending': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'amount'], 'properties': {'amount': {'type': 'number'}, 'category': {'type': 'string'}}}, 'description': "Array of {category, amount} for the user's typical monthly spend. Amounts in the local currency of the chosen region."}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4, 'minItems': 2, 'description': 'Card ids to compare, e.g. ["amex-gold-us", "chase-sapphire-preferred"].'}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['category'], 'properties': {'limit': {'type': 'number', 'description': 'Max results (default 10).'}, 'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string'}, 'category': {'type': 'string', 'description': 'Spend category — supports UK/AU terms like "petrol", "chemist", "woolworths".'}, 'card_type': {'enum': ['personal', 'business'], 'type': 'string'}, 'min_multiplier': {'type': 'number', 'description': 'Only return cards at or above this multiplier.'}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['partner_name'], 'properties': {'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string', 'description': 'Filter to programs from a specific region.'}, 'partner_name': {'type': 'string', 'description': 'Airline or hotel name, e.g. "Qantas", "Virgin Atlantic", "Hyatt".'}}}
cards_get_card
Get full details for a single card, including all multipliers, all benefits, welcome bonus, and source URL.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Card id, e.g. "amex-gold-us". Use list_cards to discover ids.'}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string', 'description': 'Filter by region/country.'}, 'provider': {'enum': ['amex', 'chase', 'bilt', 'capital-one', 'anz', 'nab', 'westpac', 'cba', 'barclaycard', 'hsbc', 'virgin-money', 'lloyds', 'currensea', 'yonder', 'other'], 'type': 'string', 'description': 'Filter by issuer.'}, 'card_type': {'enum': ['personal', 'business'], 'type': 'string', 'description': 'Filter by personal vs business.'}}}
cards_list_changes
List recent card data changes (welcome bonus updates, fee changes, multiplier edits). Useful for "what changed recently?" queries.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'days': {'type': 'number', 'description': 'Look back this many days (default 30).'}, 'limit': {'type': 'number', 'description': 'Max results (default 50).'}, 'card_id': {'type': 'string', 'description': 'Filter to changes for one card.'}}}
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).
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string', 'description': 'Filter to programs from a specific region.'}, 'provider': {'type': 'string', 'description': 'Filter to one provider, e.g. "amex" or "anz".'}, 'partner_type': {'enum': ['airline', 'hotel'], 'type': 'string'}}}
cards_rank_welcome_bonuses
List current welcome bonuses sorted by point/mile value descending. Optionally filter by spend achievability.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'number', 'description': 'Max results (default 20).'}, 'region': {'enum': ['US', 'UK', 'AU', 'DE', 'FR', 'IT', 'ES', 'NL'], 'type': 'string'}, 'card_type': {'enum': ['personal', 'business'], 'type': 'string'}, 'min_value': {'type': 'number', 'description': 'Minimum bonus point/mile value.'}, 'monthly_spend': {'type': 'number', 'description': "Monthly spend in the card's local currency. If provided, only includes bonuses where required spend ≤ monthly_spend × months."}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['target_program', 'points_needed'], 'properties': {'points_needed': {'type': 'integer', 'minimum': 1, 'description': 'How many target-program points the redemption costs'}, 'target_program': {'type': 'string', 'description': "The program you need points in (e.g. 'Asia Miles', 'Avios', 'Aeroplan', 'Virgin Points')"}}}
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.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider'], 'properties': {'provider': {'enum': ['seats_aero', 'award_wallet', 'google_sheets', 'tripit', 'autopilot'], 'type': 'string', 'description': 'Which integration to connect'}}}
create_route_monitor
Create a saved route monitor. ATF checks every 6 hours for award seats matching the route + window + cabin and emails when fresh availability appears. Free accounts get one monitor; Premium is unlimited.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'earliest_date', 'latest_date'], 'properties': {'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'airlines': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional airline filter; omit to watch all supported carriers'}, 'max_points': {'type': 'integer', 'description': 'Only fire when points <= this cap'}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'latest_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'earliest_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['prompt'], 'properties': {'prompt': {'type': 'string', 'description': 'The self-contained instruction to run each time. No conversation context is carried over.'}, 'cadence': {'enum': ['daily', 'weekly'], 'type': 'string', 'description': 'Defaults to weekly.'}, 'trip_id': {'type': 'integer', 'description': 'Optional trip to file this order under.'}, 'run_hour': {'type': 'integer', 'maximum': 23, 'minimum': 0, 'description': 'Hour of day in UTC to run. Defaults to 7.'}, 'run_weekday': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': '0=Sunday … 6=Saturday. Weekly cadence only. Defaults to Monday (1).'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': "Trip name, e.g. 'Tokyo with the family'"}, 'end_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'start_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'destination': {'type': 'string', 'description': 'Primary destination (city or airport)'}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'integer', 'minimum': 1}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'integer', 'minimum': 1}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['visit_id'], 'properties': {'visit_id': {'type': 'integer', 'description': 'Id of the logged visit, from list_lounge_visits.'}}}
delete_loyalty_status
Remove a tracked elite/loyalty status (e.g. when it lapses and the user doesn't want to renew it).
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'program': {'type': 'string'}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'program': {'type': 'string', 'description': 'Loyalty program name to remove (as shown by list_points_balances)'}}}
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.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['trip_id'], '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.'}}}
delete_voucher
Remove a voucher from the user's inventory.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['voucher_id'], 'properties': {'voucher_id': {'type': 'integer', 'minimum': 1}}}
disconnect_integration
Revoke a previously connected integration. The OAuth tokens are deleted from ATF storage.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider'], 'properties': {'provider': {'enum': ['seats_aero', 'award_wallet', 'google_sheets', 'tripit', 'autopilot'], 'type': 'string'}}}
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?'
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'description': "City name to search (e.g. 'Tokyo', 'Maldives'). Optional — omit to list all premium hotels."}, 'program': {'enum': ['any', 'amex_fhr', 'amex_thc', 'chase_edit'], 'type': 'string', 'description': 'Filter by program. Default: any.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['from_program', 'target_program'], 'properties': {'max_hops': {'type': 'integer', 'maximum': 3, 'minimum': 1, 'description': 'Max transfer steps to consider (default 3)'}, 'from_program': {'type': 'string', 'description': "Program you have points in (e.g. 'Amex Membership Rewards', 'Chase', 'Marriott Bonvoy')"}, 'points_needed': {'type': 'integer', 'minimum': 1, 'description': 'Optional: how many target-program points you need. Returns source points required per route.'}, 'target_program': {'type': 'string', 'description': "Program you want points in (e.g. 'American Airlines AAdvantage', 'Alaska', 'Avios')"}}}
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.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number', 'flight_date', 'cabin_class', 'seat_preference'], 'properties': {'cabin_class': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string', 'description': 'Cabin class to monitor'}, 'flight_date': {'type': 'string', 'description': 'Flight date in YYYY-MM-DD format. Must be today or within the next 60 days.'}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1', 'AA716'"}, 'specific_seat': {'type': 'string', 'description': "Required when seat_preference is 'specific' (e.g. '12A')"}, 'seat_preference': {'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'], 'type': 'string', 'description': 'Seat preference to alert on'}, 'adjacent_seats_count': {'type': 'integer', 'maximum': 9, 'minimum': 2, 'description': "Required when seat_preference is 'adjacent_seats' or 'minimum_seats' (2-9)"}}}
fs_delete_seat_alert
Delete a seat alert by its ID. Use list_seat_alerts to find the alert ID. Requires authentication.
Destructivo
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['alert_id'], 'properties': {'alert_id': {'type': 'integer', 'description': 'ID of the seat alert to delete'}}}
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.
Solo lectura
Esquema de entrada
{'type': 'object', '$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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number', 'preferences'], 'properties': {'cabin_class': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string', 'description': 'Optional cabin class filter'}, 'flight_date': {'type': 'string', 'description': 'Optional flight date in YYYY-MM-DD format'}, 'preferences': {'type': 'array', 'items': {'enum': ['window', 'aisle', 'extra_legroom', 'exit_row', 'quiet_zone', 'front', 'rear', 'bulkhead'], 'type': 'string'}, 'description': 'Seat preferences to match'}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1'"}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number', 'seat_number'], 'properties': {'flight_date': {'type': 'string', 'description': 'Optional flight date in YYYY-MM-DD format'}, 'seat_number': {'type': 'string', 'description': "Seat number, e.g. '12A', '1F', '32K'"}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1'"}}}
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).
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number'], 'properties': {'flight_date': {'type': 'string', 'description': 'Optional flight date in YYYY-MM-DD format'}, 'flight_number': {'type': 'string', 'description': "Flight number including airline code, e.g. 'QF1', 'AA716', 'BA178'"}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number'], 'properties': {'seat_number': {'type': 'string', 'description': "Optional seat number to filter reviews (e.g. '12A')"}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1'"}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number'], 'properties': {'flight_date': {'type': 'string', 'description': 'Optional flight date in YYYY-MM-DD format'}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1', 'AA716'"}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$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.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number'], 'properties': {'flight_date': {'type': 'string', 'description': 'Flight date in YYYY-MM-DD format (defaults to today)'}, 'flight_number': {'type': 'string', 'description': "Flight number, e.g. 'QF1', 'AA716'"}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'program': {'type': 'string', 'description': "Programme slug or loose name, e.g. 'aeroplan', 'British Airways', 'avios', 'world-of-hyatt'."}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline'], 'properties': {'airline': {'type': 'string', 'description': "IATA code (e.g. 'BA') or carrier name (e.g. 'British Airways')."}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['trip_id'], 'properties': {'trip_id': {'type': 'string', 'description': 'The `trip_id` field from an award search result row'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', '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).'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline'], 'properties': {'airline': {'type': 'string', 'description': "Airline slug or name, e.g. 'british-airways', 'Qatar Airways', 'virgin'."}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program', 'airline'], 'properties': {'airline': {'type': 'string', 'pattern': '^[A-Z0-9]{2}$', 'description': 'Operating airline IATA code (e.g. AA, BA, QR)'}, 'program': {'enum': ['british-airways', 'aeroplan', 'alaska', 'american-aadvantage', 'virgin-atlantic', 'flying-blue'], 'type': 'string', 'description': 'Loyalty program to credit to'}, 'fare_class': {'type': 'string', 'description': 'Optional booking class letter (e.g. K, M, Y). If omitted, returns the full table for that program×airline.'}}}
get_flight_booking
Get details of a specific flight booking/redemption.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'integer', 'minimum': 1}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['hotel_code', 'check_in_date', 'check_out_date'], '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}$'}}}
get_hotel_booking
Get details and full price history of a monitored hotel booking.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'booking_id': {'type': 'integer', 'minimum': 1}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['carrier', 'departure', 'destination'], '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).'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['currency'], 'properties': {'currency': {'type': 'string', 'description': 'Points/miles currency — a slug (chase-ultimate-rewards) or loose name ("amex points", "marriott", "hyatt").'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline', 'departure_code', 'arrival_code'], 'properties': {'airline': {'enum': ['british_airways', 'qatar_airways', 'cathay_pacific', 'virgin_atlantic', 'iberia', 'emirates', 'qantas'], 'type': 'string'}, 'arrival_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'departure_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'program': {'enum': ['aeroplan', 'aadvantage', 'singapore-krisflyer', 'cathay-asia-miles', 'turkish-miles-smiles', 'ana-mileage-club'], 'type': 'string', 'description': 'Programme slug.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'program': {'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'], 'type': 'string', 'description': 'Loyalty program slug (e.g. british-airways, emirates, aeroplan)'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'Skill key from list_skills'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'alliance': {'enum': ['SkyTeam', 'Star Alliance', 'oneworld'], 'type': 'string', 'description': 'Filter by airline alliance'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'program': {'type': 'string', 'description': 'Optional — limit to a single program slug. Omit to return all tracked statuses.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_number'], 'properties': {'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'}, 'flight_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Optional departure date'}, 'flight_number': {'type': 'string', 'pattern': '^[A-Za-z0-9]{2,3}\\s*\\d{1,4}$', 'description': 'Flight code such as BA117 or AA 100'}}}
list_award_release_windows
List all known per-airline award booking windows. Useful when the user asks 'when do award seats open?' generally.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_flight_bookings
List all tracked flight award bookings/redemptions. Shows airlines, routes, points spent, and cabin classes.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_hotel_bookings
List all hotel bookings being monitored for price drops. Shows current vs. original points rates.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_lounge_visits
List the airport lounge visits you've logged to your portfolio.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_loyalty_statuses
List the user's tracked elite/loyalty statuses across airlines and hotels.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_my_vouchers
List the companion/upgrade vouchers the user holds, including which booking each is applied to. Paid feature.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_points_balances
List all your loyalty program points/miles balances.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_route_monitors
List the user's saved route monitors with their last-checked time and current status.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Page number (1-indexed). Defaults to 1.'}, 'status': {'enum': ['all', 'active', 'paused', 'cancelled', 'fired'], 'type': 'string'}, 'per_page': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Items per page (default 20, max 100).'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'include_inactive': {'type': 'boolean', 'description': 'Include cancelled/paused orders. Defaults to false.'}}}
list_supported_airlines
List the airlines ATF can search for award seats, with their LIVE status: which returned real award data in the last 72h, which are degraded (source down, blocked, or behind a member login) and which are idle. search_all_airlines only fans out to live sources, so call this before promising coverage or when a search comes back thin. Public, no sign-in.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_trips
List the signed-in user's trips (their trip-as-project workspaces) with destination, dates, status, and itinerary section count.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'status': {'enum': ['all', 'active', 'archived', 'planning', 'booked', 'completed'], 'type': 'string', 'description': 'Filter by status (default: all)'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'region': {'enum': ['UK', 'US'], 'type': 'string', 'description': 'Filter by issuer region.'}, 'category': {'enum': ['companion', 'upgrade', 'companion_pass', 'upgrade_cert'], 'type': 'string', 'description': 'Filter by voucher category.'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airport_code', 'lounge_name', 'visit_date'], 'properties': {'notes': {'type': 'string', 'description': 'Optional notes'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Optional 1-5 rating'}, 'visit_date': {'type': 'string', 'description': 'Date of the visit (YYYY-MM-DD)'}, 'lounge_name': {'type': 'string', 'description': 'Lounge name, e.g. Qantas First Lounge'}, 'airport_code': {'type': 'string', 'description': 'Airport IATA code, e.g. LHR'}, 'access_method': {'type': 'string', 'description': 'How you got in, e.g. Priority Pass, Amex Platinum, business ticket'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['flight_code'], 'properties': {'flight_code': {'type': 'string', 'description': "A flight code like 'BA117', 'AA 1234', or 'EK521'."}}}
lounge_add_to_wishlist
Add a lounge to your wishlist. Idempotent — adding a lounge already on your wishlist is a no-op.
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'lounge_slug': {'type': 'string', 'description': 'Lounge slug (from search results)'}}}
lounge_delete_review
Delete your review of a lounge. Identify it by lounge_slug.
Destructivo
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'lounge_slug': {'type': 'string', 'description': 'Lounge slug of the review to delete'}}}
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.
Destructivo
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'visited_at': {'type': 'string', 'format': 'date', 'description': 'Visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits'}, 'lounge_slug': {'type': 'string', 'description': 'Lounge slug of the visit to delete'}}}
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?'
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['access_method'], 'properties': {'access_method': {'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'], 'type': 'string', 'description': 'Access method slug (e.g. amex-platinum, priority-pass, chase-sapphire-reserve, business-class, star-alliance-gold)'}}}
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['iata'], 'properties': {'iata': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Airport IATA code (e.g. LHR, JFK, SIN)'}}}
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Lounge slug (from search results or airport lounges)'}}}
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.
Solo lectura
Idempotente
Esquema de entrada
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'description': 'Max reviews to return (default 20, max 50)'}}}
lounge_get_my_visits
Get your visited lounges list with dates and notes.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'description': 'Max visits to return (default 20, max 50)'}}}
lounge_get_my_wishlist
Get your lounge wishlist — lounges you want to visit.
Solo lectura
Idempotente
Esquema de entrada
{'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).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['network'], 'properties': {'network': {'enum': ['priority-pass', 'loungekey', 'dragonpass', 'plaza-premium', 'amex-centurion'], 'type': 'string', 'description': 'Network slug (priority-pass, loungekey, dragonpass, plaza-premium, amex-centurion)'}}}
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.
Solo lectura
Idempotente
Esquema de entrada
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$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.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['visited_at'], 'properties': {'notes': {'type': 'string', 'description': 'Optional notes about your visit'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Your rating, 1 (poor) to 5 (excellent)'}, 'visited_at': {'type': 'string', 'format': 'date', 'description': 'Date of visit (YYYY-MM-DD)'}, 'lounge_name': {'type': 'string', 'description': "Lounge name — use with airport_iata if you don't have the slug."}, 'lounge_slug': {'type': 'string', 'description': 'Lounge slug (from search results). Preferred if known.'}, 'airport_iata': {'type': 'string', 'description': '3-letter airport IATA code — use with lounge_name.'}}}
lounge_remove_from_wishlist
Remove a lounge from your wishlist.
Destructivo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'lounge_slug': {'type': 'string', 'description': 'Lounge slug (from search results)'}}}
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'minLength': 2, 'description': 'Search query (lounge name, airport name, IATA code, city, or country)'}}}
lounge_update_review
Update your review of a lounge — change the rating and/or the text. Identify the review by lounge_slug.
Destructivo
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'New rating, 1-5'}, 'content': {'type': 'string', 'minLength': 10, 'description': 'New review text (minimum 10 characters)'}, 'lounge_slug': {'type': 'string', 'description': 'Lounge slug of the review to update'}}}
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.
Destructivo
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug'], 'properties': {'notes': {'type': 'string', 'description': 'New notes'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'New rating, 1-5'}, 'visited_at': {'type': 'string', 'format': 'date', 'description': 'Existing visit date (YYYY-MM-DD) — needed only to disambiguate multiple visits'}, 'lounge_slug': {'type': 'string', 'description': 'Lounge slug of the visit to update'}, 'new_visited_at': {'type': 'string', 'format': 'date', 'description': 'Change the visit date to this (YYYY-MM-DD)'}}}
lounge_write_review
Write a review for a lounge. Requires the lounge slug, a rating (1-5), and review text (min 10 characters).
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['lounge_slug', 'rating', 'content'], 'properties': {'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Rating from 1 (poor) to 5 (excellent)'}, 'content': {'type': 'string', 'minLength': 10, 'description': 'Review text (minimum 10 characters)'}, 'lounge_slug': {'type': 'string', 'description': 'Lounge slug (from search results)'}}}
monitor_hotel_price
Start monitoring a hotel points booking for price drops. Checks daily and sends email alerts when the points rate decreases. Paid feature.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['hotel_code', 'check_in_date', 'check_out_date', 'original_points', 'room_type', 'rate_plan'], 'properties': {'notes': {'type': 'string'}, 'rate_plan': {'type': 'string'}, 'room_type': {'type': 'string'}, '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)'}, 'confirmation_number': {'type': 'string'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'flexibility_days': {'type': 'integer', 'maximum': 14, 'minimum': 0, 'description': 'Optional ± days flexibility — if set, also probes adjacent dates'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['target_program'], 'properties': {'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."}, 'target_program': {'type': 'string', 'description': "Program slug to reach status with — e.g. 'qatar-privilege-club', 'british-airways-executive-club'."}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['blocks'], 'properties': {'title': {'type': 'string', 'description': 'Card heading, e.g. "SFO → NRT in business".'}, 'blocks': {'type': 'array', 'items': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'enum': ['stats', 'table', 'bars', 'steps', 'list', 'note'], 'type': 'string', 'description': 'Block kind.'}, 'rows': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'string'}}, 'description': 'table: rows of cell strings.'}, 'text': {'type': 'string', 'description': 'note: the callout body.'}, 'tone': {'enum': ['info', 'warn', 'success', 'danger'], 'type': 'string', 'description': 'note: callout tone.'}, 'unit': {'type': 'string', 'description': 'bars: unit shown after each value, e.g. "pts".'}, 'items': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Rows for stats/bars/steps/list. Objects whose keys depend on the kind.'}, 'caption': {'type': 'string', 'description': 'table: optional caption under the table.'}, 'columns': {'type': 'array', 'items': {'type': 'string'}, 'description': 'table: column headers.'}}}, 'description': 'Blocks to render, in order. Max 10.'}, 'subtitle': {'type': 'string', 'description': 'One-line context under the heading.'}}}
search_all_airlines
Search award flight availability across every airline currently LIVE for a route and date, in parallel. The live list is measured from real searches in the last 72h (see list_supported_airlines); airlines whose source is down, blocked or login-walled are not fanned out to, and the response's `coverage` field says how many were. Any catalogued airline can still be requested by name with search_availability. 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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['departure_code', 'arrival_code', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Travel date (YYYY-MM-DD)'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string', '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', 'maximum': 7, 'minimum': 0, '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.'}, 'arrival_code': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'Arrival airport IATA code (e.g. JFK)'}, 'departure_code': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'Departure airport IATA code (e.g. LHR)'}}}
search_availability
Search live award availability for a specific airline, route, and date. 30 airlines can be requested, but only those list_supported_airlines reports as live are returning seats right now — 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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline', 'departure_code', 'arrival_code', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string', '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.'}, 'airline': {'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', 'smiles', 'qantas_rewards', 'alaska_direct'], 'type': 'string'}, 'arrival_code': {'type': 'string', 'description': 'IATA code (SIN), or a city or airport name'}, 'departure_code': {'type': 'string', 'description': 'IATA code (LHR), or a city or airport name (Heathrow, Tokyo)'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'source': {'enum': ['auto', 'duffel', 'ignav', 'airtrfx'], 'type': 'string', '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."}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'brand': {'enum': ['Marriott', 'Hilton', 'IHG', 'Hyatt'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Hotel name or city'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['origin', 'destination', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'business', 'first'], 'type': 'string', 'description': 'Target cabin class (default: business)'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'points_value_cents': {'type': 'number', 'description': 'How you value points in cents/pence per point (default: 1.5)'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many excerpts to return (default 5)'}, 'query': {'type': 'string', 'description': "Natural-language question or topic, e.g. 'best Avios redemption sweet spots from London'"}, 'source': {'enum': ['miles_and_points_daily', 'smart_with_points'], 'type': 'string', 'description': 'Restrict to one publication. Omit to search both.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'card': {'type': 'string', 'description': "Filter to a specific card by name (e.g. 'Amex Gold'). Optional."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max entries to return (default 20).'}, 'query': {'type': 'string', 'description': "Merchant, card, or category to search for (e.g. 'Whole Foods', 'Amex Gold', 'Dining'). Optional."}, 'country': {'type': 'string', 'description': "Two-letter country code to filter by (e.g. 'US', 'UK'). Optional."}, 'category': {'type': 'string', 'description': "Filter to a bonus category (e.g. 'Groceries', 'Dining'). Optional."}, 'min_multiplier': {'type': 'number', 'description': 'Only return entries earning at least this multiplier (e.g. 4 for 4x and up). Optional.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airline', 'departure_code', 'arrival_code', 'date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}(-\\d{2})?$', 'description': 'Month to search (YYYY-MM or YYYY-MM-DD)'}, 'airline': {'enum': ['british_airways', 'qatar_airways', 'cathay_pacific', 'virgin_atlantic', 'iberia', 'qantas', 'qantas_rewards', 'etihad', 'smiles'], 'type': 'string'}, 'arrival_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'departure_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['departure_code', 'arrival_code', 'date', 'passengers'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 2}, 'arrival_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'departure_code': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many excerpts to return (default 5).'}, 'query': {'type': 'string', 'description': "Natural-language question or topic to find in the user's documents."}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program', 'tier'], 'properties': {'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."}, 'notes': {'type': 'string', 'description': 'Optional notes (free-form).'}, '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."}, '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.'}, 'target_tier': {'type': 'string', 'description': 'Optional — a tier the user is chasing (must be a valid tier for the program).'}, '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.'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program'], 'properties': {'tier': {'type': 'string', 'description': "Optional — the user's CURRENT tier. Required only if no status is tracked for this program yet."}, 'program': {'type': 'string', 'description': "Loyalty program slug — e.g. 'british-airways-executive-club', 'marriott-bonvoy'."}, '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."}, '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).'}}}
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.
Destructivo
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['type', 'summary', 'details', 'confirmed'], 'properties': {'type': {'enum': ['feedback', 'bug'], 'type': 'string', 'description': 'Whether this is general feedback or a bug report.'}, 'details': {'type': 'string', 'maxLength': 4000, 'description': 'What the user wants the Award Travel Finder team to know.'}, 'summary': {'type': 'string', 'maxLength': 160, 'description': 'A concise title for the feedback or bug.'}, '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.'}, 'actual_behavior': {'type': 'string', 'maxLength': 4000, 'description': 'For bugs, what actually happened.'}, 'expected_behavior': {'type': 'string', 'maxLength': 4000, 'description': 'For bugs, what the user expected to happen.'}, 'steps_to_reproduce': {'type': 'string', 'maxLength': 4000, 'description': 'For bugs, the steps that reproduce the problem, if known.'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['airline_code'], 'properties': {'airline_code': {'type': 'string', 'description': 'IATA airline code, e.g. "UA" for United, "DL" for Delta'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['flight_number'], 'properties': {'flight_number': {'type': 'string', 'description': 'IATA flight number, e.g. "UA123" or "DL456"'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'airline_code': {'type': 'string', 'description': 'Optional IATA airline code to filter rollouts, e.g. "UA"'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'airline_code': {'type': 'string', 'description': 'IATA airline code, e.g. "UA"'}, 'flight_number': {'type': 'string', 'description': 'IATA flight number, e.g. "UA123"'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tail_number'], 'properties': {'tail_number': {'type': 'string', 'description': 'Aircraft registration / tail number, e.g. "N12345"'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['flight_number'], 'properties': {'date': {'type': 'string', 'description': 'Flight date in YYYY-MM-DD format. Defaults to today.'}, 'flight_number': {'type': 'string', 'description': 'IATA flight number, e.g. "UA123"'}}, 'additionalProperties': False}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Search query, e.g. "United" or "UA123"'}}, 'additionalProperties': False}
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.
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'provider': {'enum': ['seats_aero', 'award_wallet', 'google_sheets', 'tripit', 'autopilot'], 'type': 'string', 'description': 'Optional — sync just this provider. Omit to sync all connected integrations.'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'kind': {'enum': ['award', 'cash'], 'type': 'string'}, 'notes': {'type': 'string'}, 'origin': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'airline': {'type': 'string'}, 'program': {'type': 'string'}, 'trip_id': {'type': 'string'}, 'cash_paid': {'type': 'number', 'minimum': 0}, 'booking_id': {'type': 'integer', 'minimum': 1}, 'taxes_paid': {'type': 'number'}, 'cabin_class': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'destination': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'return_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'points_spent': {'type': 'integer', 'minimum': 0}, 'flight_number': {'type': 'string'}, 'departure_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'confirmation_number': {'type': 'string'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['booking_id'], 'properties': {'kind': {'enum': ['award', 'cash'], 'type': 'string'}, 'notes': {'type': 'string'}, 'hotel_id': {'type': 'string'}, 'rate_plan': {'type': 'string'}, 'room_type': {'type': 'string'}, 'booking_id': {'type': 'integer', 'minimum': 1}, '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': 0}, 'cash_rate_currency': {'type': 'string'}, 'monitoring_enabled': {'type': 'boolean'}, 'confirmation_number': {'type': 'string'}, 'original_pay_rate_usd': {'type': 'number', 'minimum': 0}}}
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).
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['heading', 'body'], 'properties': {'body': {'type': 'string', 'description': 'Section body in markdown'}, 'kind': {'enum': ['flight', 'hotel', 'note', 'budget'], 'type': 'string', 'description': 'Section kind (default: note)'}, 'heading': {'type': 'string', 'description': "Section heading, e.g. 'Outbound flight' or 'Hotel: Tokyo'"}, '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.'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['program', 'balance'], 'properties': {'balance': {'type': 'integer', 'minimum': 0}, 'program': {'type': 'string', 'description': 'Loyalty program name'}}}
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.
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['monitor_id'], 'properties': {'cabin': {'enum': ['economy', 'premium_economy', 'business', 'first'], 'type': 'string'}, 'status': {'enum': ['active', 'paused'], 'type': 'string', 'description': 'Pause or resume the monitor'}, 'airlines': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Replaces the existing airline filter; pass [] to watch all carriers'}, 'max_points': {'type': 'integer'}, 'monitor_id': {'type': 'integer'}, 'passengers': {'type': 'integer', 'maximum': 9, 'minimum': 1}, 'latest_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'earliest_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}}}
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.It also returns what is included and excluded in the price, high-level itinerary metadata, bookable experience options, traveler age bands and booking constraints, start/end locations and traveler pickup, additional information such as requirements and restrictions, available language guides, associated destinations, the operating time zone, the operator, every image for the experience with its available dimension variants and captions, and the cancellation policy covering the refund terms, weather and minimum-traveler cancellation conditions, and how much is refundable depending on how far in advance the booking is cancelled.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
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['code', 'sessionId'], '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.'}, '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.'}, 'language': {'type': 'string', 'description': '(deprecated) This value is deprecated and should not be sent. Please only send the locale.'}, '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.'}}}
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 >
Solo lectura
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['searchTerm', 'startDate', 'endDate', 'sessionId'], 'properties': {'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.'}, '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."}, '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'}, '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”).'}, '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.'}, '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."}, 'searchTerm': {'type': 'string', 'description': "(required) Natural-language description of what the user is looking for. Must be non-blank and at most 500 characters; the tool rejects empty, whitespace-only, or over-length 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."}}}
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?'.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'program': {'type': 'string', 'description': "Filter to a single program (e.g. 'Avios', 'Marriott Bonvoy')"}, 'category': {'enum': ['all', 'airline', 'hotel', 'transfer'], 'type': 'string', 'description': 'Filter (default: all)'}}}
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.
Solo lectura
Acceso externo
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['airport_code'], 'properties': {'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'}, 'airport_code': {'type': 'string', 'pattern': '^[A-Z]{3,4}$', 'description': 'IATA (3-letter) or ICAO (4-letter) airport code'}}}
Historial
Cambios recientes en herramientas
Modificado
viator_search_experiences
19 de September de 2026 a las 02:50
Modificado
viator_get_experience_details
19 de September de 2026 a las 02:50
Modificado
cards_find_transfer_programs_for_airline
19 de September de 2026 a las 02:50
Modificado
cards_list_transfer_partners
19 de September de 2026 a las 02:50
Modificado
cards_list_changes
19 de September de 2026 a las 02:50
Modificado
cards_analyze_spending
19 de September de 2026 a las 02:50
Modificado
cards_rank_welcome_bonuses
19 de September de 2026 a las 02:50
Modificado
cards_find_cards_for_category
19 de September de 2026 a las 02:50
Modificado
cards_compare_cards
19 de September de 2026 a las 02:50
Modificado
cards_get_card
19 de September de 2026 a las 02:50
Modificado
cards_list_cards
19 de September de 2026 a las 02:50
Modificado
lounge_remove_from_wishlist
19 de September de 2026 a las 02:50
Modificado
lounge_add_to_wishlist
19 de September de 2026 a las 02:50
Modificado
lounge_get_my_wishlist
19 de September de 2026 a las 02:50
Modificado
lounge_delete_visit
19 de September de 2026 a las 02:50
Modificado
lounge_update_visit
19 de September de 2026 a las 02:50
Modificado
lounge_mark_lounge_visited
19 de September de 2026 a las 02:50
Modificado
lounge_get_my_visits
19 de September de 2026 a las 02:50
Modificado
lounge_delete_review
19 de September de 2026 a las 02:50
Modificado
lounge_update_review
19 de September de 2026 a las 02:50
Modificado
lounge_write_review
19 de September de 2026 a las 02:50
Modificado
lounge_get_my_reviews
19 de September de 2026 a las 02:50
Modificado
lounge_get_my_passport
19 de September de 2026 a las 02:50
Modificado
lounge_get_my_profile
19 de September de 2026 a las 02:50
Modificado
lounge_discover_more_flight_tools
19 de September de 2026 a las 02:50
Modificado
lounge_get_network_lounges
19 de September de 2026 a las 02:50
Modificado
lounge_list_networks
19 de September de 2026 a las 02:50
Modificado
lounge_list_access_methods
19 de September de 2026 a las 02:50
Modificado
lounge_find_lounges_by_access
19 de September de 2026 a las 02:50
Modificado
lounge_get_lounge_details
19 de September de 2026 a las 02:50
Descubrir
Servidores MCP similares
Cancun4me — Reservas de Hotel
me.cancun4/reservas
Searches, quotes, books, tracks, cancels, and provides vouchers for hotels in Cancun and Riviera Maya, with Stripe payment links.
x402card: Virtual Cards + Freeland eSIM
org.x402card/freeland-esim
Supports x402 virtual-card issuance and top-ups and lists prepaid travel eSIM plans payable with Base USDC.
esimker eSIM store
com.esimker/esim
Searches travel eSIM plans and enables purchases, top-ups, wallet funding, and checkout through card, crypto, or prepaid balance.
Hotel Booking AI MCP
io.github.tourmind-com/hotel-booking-ai-mcp
Searches hotels and live room rates, checks availability, creates and manages bookings, and generates payment requests.
booking
com.mydriverparis/booking
Resolves travel locations, flights, and trains; obtains private-driver quotes; and creates payment links for Paris transfers and …
Gitsim Chat
com.gitsim/chat
Searches, orders and manages international eSIM data packages and provides Stripe checkout links for purchases and top-ups.
topup
app.iomarkets/topup
Lists and sells travel eSIMs, mobile top-ups, prepaid services, and international payment offers using user-approved USDC wallet …
pifini
net.pifini/pifini
Searches events and places across the Caribbean and Latin America, provides listings and reviews, and creates hosted ticket payme…