Build agents on the canonical award travel layer

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "card": {
      "type": "string",
      "description": "Catalogue slug or card name, or any free-text card name."
    },
    "nickname": {
      "type": "string",
      "description": "Optional nickname, e.g. 'my travel card'."
    },
    "opened_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional ISO date the card was opened."
    },
    "closed_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional ISO date the card was closed."
    },
    "notes": {
      "type": "string",
      "description": "Optional notes."
    },
    "custom": {
      "type": "boolean",
      "description": "Save as a free-text card without catalogue matching."
    },
    "bonus_amount": {
      "type": [
        "integer",
        "string"
      ],
      "description": "Welcome bonus size as a whole number, e.g. 80000. Empty string clears it."
    },
    "bonus_currency": {
      "type": "string",
      "description": "What the bonus is paid in, e.g. 'Chase Ultimate Rewards points', 'Amex Membership Rewards points' or 'cash back'."
    },
    "bonus_status": {
      "type": "string",
      "enum": [
        "pending",
        "earned",
        "missed",
        ""
      ],
      "description": "pending: the bonus is offered but the spend requirement is not met yet. earned: the bonus has posted (also set bonus_earned_on). missed: the deadline passed without it. Leave unset if unknown. Empty string clears it."
    },
    "bonus_earned_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD the bonus was earned; empty string clears it."
    },
    "spend_requirement": {
      "type": [
        "number",
        "string"
      ],
      "description": "Minimum spend to earn the bonus, in whole currency units (4000 means $4,000). Empty string clears it."
    },
    "spend_deadline_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD by which the spend requirement must be met; empty string clears it."
    },
    "spend_window_months": {
      "type": [
        "integer",
        "string"
      ],
      "enum": [
        1,
        2,
        3,
        6,
        12,
        "1",
        "2",
        "3",
        "6",
        "12",
        ""
      ],
      "description": "Months from the opened date to meet the spend requirement (1, 2, 3, 6 or 12). The server works out spend_deadline_on from opened_on. Used only when spend_deadline_on is not given; needs an opened date."
    },
    "annual_fee": {
      "type": [
        "number",
        "string"
      ],
      "description": "Annual fee in whole currency units (95 means $95). Empty string clears it."
    },
    "currency": {
      "type": "string",
      "description": "3-letter currency code for spend_requirement and annual_fee. Defaults to USD."
    },
    "country": {
      "type": "string",
      "description": "2-letter ISO country code of the card, for example GB, US, CA or AU (UK is accepted for GB). Catalogue cards use the catalogue country when this is not set. Empty string resets it to the catalogue country."
    }
  },
  "required": [
    "card"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "candidate": {
      "type": "string",
      "description": "The offer, e.g. 'Hilton Honors buy points 100% bonus ends 2026-09-25'"
    },
    "recent": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recent post titles or texts, newest first (max 50)"
    }
  },
  "required": [
    "candidate",
    "recent"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "integer",
      "description": "User id"
    },
    "email": {
      "type": "string",
      "description": "User email (exact match)"
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "search": {
      "type": "string",
      "description": "Filter by email substring"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-indexed). Defaults to 1."
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Items per page (default 20, max 100)."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Window for daily_volume/tool_error_rates, default 14"
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Window for signups_by_day, default 30"
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "program": {
      "type": "string",
      "description": "Program name or slug. Supported: avios, british-airways."
    },
    "origin": {
      "type": "string",
      "description": "Origin city or IATA code. Only London is supported. Omit for London."
    },
    "balance": {
      "type": "integer",
      "minimum": 1,
      "description": "Avios balance."
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "business"
      ],
      "description": "Optional cabin."
    }
  },
  "required": [
    "program",
    "balance"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin IATA code."
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination IATA code."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Departure date, YYYY-MM-DD."
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin (default economy)."
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "client_name": {
      "type": "string"
    },
    "client_email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "balances": {
      "type": "object",
      "description": "Map of program → points balance (e.g. { 'Avios': 240000 })"
    },
    "preferences": {
      "type": "object",
      "description": "Free-form prefs: cabin, preferred airlines, anchor airports, etc."
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "client_name"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "airport": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Airport IATA code, e.g. JFK."
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "email",
          "sms",
          "whatsapp"
        ]
      },
      "description": "How to notify. Defaults to email."
    },
    "phone_number": {
      "type": "string",
      "description": "Required when channels include sms or whatsapp."
    },
    "min_delay_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 600,
      "description": "Only alert when the delay is at least this long. Defaults to 30."
    },
    "label": {
      "type": "string",
      "description": "Optional name for the alert."
    }
  },
  "required": [
    "airport"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "BA",
        "VS",
        "CX",
        "IB",
        "QR",
        "EY",
        "JL",
        "B6",
        "UA",
        "TP",
        "HA",
        "FI"
      ],
      "description": "Two-letter airline code."
    },
    "departure": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Departure airport IATA code."
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination airport IATA code."
    },
    "date_range_start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_range_end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Omit for any cabin."
    }
  },
  "required": [
    "airline",
    "departure",
    "destination",
    "date_range_start",
    "date_range_end"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "alert_id": {
      "type": "integer",
      "description": "Delay alert id from list_delay_alerts."
    }
  },
  "required": [
    "alert_id"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "alert_id": {
      "type": "integer",
      "description": "Flight alert id from list_flight_alerts."
    }
  },
  "required": [
    "alert_id"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "notification_id": {
      "type": "string",
      "description": "Notification id from list_notifications."
    }
  },
  "required": [
    "notification_id"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "program": {
      "type": "string",
      "description": "Canonical loyalty program slug to remove (as shown by list_points_balances)",
      "enum": [
        "accor-all",
        "aegean-miles-bonus",
        "aer-lingus-aerclub",
        "air-canada-aeroplan",
        "air-france-klm-flying-blue",
        "air-india-maharaja-club",
        "air-new-zealand-koru",
        "alaska-atmos-rewards",
        "american-aadvantage",
        "amex-membership-rewards",
        "amex-membership-rewards-uk",
        "ana-mileage-club",
        "best-western-rewards",
        "bilt-rewards",
        "british-airways-executive-club",
        "capital-one-miles",
        "cathay-pacific-cathay",
        "chase-ultimate-rewards",
        "china-airlines-dynasty-flyer",
        "choice-privileges",
        "citi-thankyou-points",
        "delta-skymiles",
        "emirates-skywards",
        "etihad-guest",
        "eva-air-infinity-mileagelands",
        "finnair-plus",
        "frontier-miles",
        "garuda-indonesia-garudamiles",
        "hilton-honors",
        "iberia-club",
        "ihg-one-rewards",
        "jal-mileage-bank",
        "jetblue-trueblue",
        "korean-air-skypass",
        "lufthansa-miles-and-more",
        "malaysia-airlines-enrich",
        "marriott-bonvoy",
        "mea-cedar-miles",
        "meliarewards",
        "minor-discovery",
        "oman-air-sindbad",
        "philippine-airlines-mabuhay-miles",
        "qantas-frequent-flyer",
        "qatar-privilege-club",
        "radisson-rewards",
        "royal-jordanian-royal-club",
        "sas-eurobonus",
        "singapore-krisflyer",
        "southwest-rapid-rewards",
        "tap-miles-go",
        "thai-airways-royal-orchid-plus",
        "turkish-airlines-miles-and-smiles",
        "united-mileageplus",
        "velocity-frequent-flyer",
        "vietnam-airlines-lotusmiles",
        "virgin-atlantic-flying-club",
        "world-of-hyatt",
        "wyndham-rewards"
      ]
    }
  },
  "required": [
    "program"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "Must be true to delete. Ask the user first."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin IATA code."
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Destination IATA code."
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin (default economy)."
    },
    "programs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional programme filter, e.g. ['flying-blue', 'virgin-atlantic', 'United']."
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Origin IATA code, e.g. LHR. Use the user's home airport from session context when known."
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin (default economy)."
    },
    "month_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "First month, YYYY-MM (default this month)."
    },
    "month_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Last month, YYYY-MM (default month_from + 2)."
    },
    "points_balance": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional points balance to test."
    },
    "program": {
      "type": "string",
      "description": "Programme or card currency for points_balance, e.g. 'Amex Membership Rewards', 'Avios'."
    }
  },
  "required": [
    "origin"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "goal_program": {
      "type": "string",
      "description": "Status programme slug, e.g. 'british-airways-executive-club'."
    },
    "goal_tier": {
      "type": "string",
      "description": "Goal tier, e.g. 'Gold'. Defaults to the tracked target or next tier."
    },
    "deadline": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date the tier must be reached by, YYYY-MM-DD."
    },
    "home_airport": {
      "type": "string",
      "description": "Home airport IATA code, e.g. 'LHR'."
    }
  },
  "required": [
    "goal_program",
    "deadline",
    "home_airport"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "title": {
      "type": "string",
      "description": "Document title (default: 'Award Travel Recommendation')"
    },
    "summary": {
      "type": "string",
      "description": "Lead paragraph the advisor wants on the cover"
    },
    "flights": {
      "type": "array",
      "description": "Array of flight rows from a prior search tool result"
    },
    "client_portfolio_id": {
      "type": "integer",
      "description": "Optional ClientPortfolio ID to embed balance summary"
    },
    "advisor_brand": {
      "type": "object",
      "description": "Optional brand overrides: name, tagline, logo_url, accent_color"
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$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)."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "flight_id": {
      "type": "string",
      "description": "Id from list_flights, e.g. LHR_JFK_2026-11-10_business_3"
    }
  },
  "required": [
    "flight_id"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "booking_id": {
      "type": "integer",
      "description": "Id of a saved flight booking (from list_flight_bookings)."
    },
    "flight_number": {
      "type": "string",
      "description": "Flight code such as BA117 or AA 100."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Local departure date, YYYY-MM-DD. Defaults to today."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel id from list_hotels (starts with htl_)"
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Default 2"
    },
    "rooms": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "Default 1"
    }
  },
  "required": [
    "hotel_id",
    "check_in_date",
    "check_out_date"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "key": {
      "type": "string",
      "description": "Skill key from list_skills, e.g. a knowledge skill or an agent_readable task skill"
    }
  },
  "required": [
    "key"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "target_date": {
      "type": "string",
      "description": "Trip date (YYYY-MM-DD) to project the points balance to. Optional."
    },
    "starting_balance": {
      "type": "integer",
      "description": "Points the user holds now in the target currency. Optional."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

{
  "$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."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "trip": {
      "type": "string",
      "description": "Optional trip slug or id. Omit for the current or next trip."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "dry_run": {
      "type": "boolean",
      "description": "Propose only. Defaults to true. Pass false to apply after the user confirms."
    },
    "gap_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 14,
      "description": "Bookings whose dates are this many days apart or fewer are grouped. Defaults to 2."
    },
    "only_groups": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Group ids from the dry run to apply, from the dry run with the same gap_days. Omit to apply all."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Id of a document the user uploaded (image or PDF)."
    },
    "image_base64": {
      "type": "string",
      "description": "Base64 image or PDF bytes, or a data URI (data:image/png;base64,...), when there is no document_id."
    },
    "media_type": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/gif",
        "image/webp",
        "application/pdf"
      ],
      "description": "Media type of image_base64. Optional when image_base64 is a data URI."
    },
    "apply": {
      "type": "boolean",
      "description": "false = preview only (default). true = save the balances of preview_id."
    },
    "preview_id": {
      "type": "string",
      "description": "The preview_id from the preview call. Required when apply is true."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "text": {
      "type": "string",
      "description": "The full confirmation text: email subject and body, or the text of a booking document."
    },
    "subject": {
      "type": "string",
      "description": "Optional email subject line."
    },
    "document_id": {
      "type": "integer",
      "description": "Optional id of a document the user uploaded."
    },
    "import_id": {
      "type": "integer",
      "description": "With confirm: true, the import_id of a pending change or cancellation the user agreed to."
    },
    "confirm": {
      "type": "boolean",
      "description": "Set to true, with import_id, only after the user agrees to apply the change or cancellation."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Id of a document the user uploaded (image or PDF)."
    },
    "image_base64": {
      "type": "string",
      "description": "Base64 image or PDF bytes, or a data URI (data:image/png;base64,...), when there is no document_id."
    },
    "media_type": {
      "type": "string",
      "enum": [
        "image/jpeg",
        "image/png",
        "image/gif",
        "image/webp",
        "application/pdf"
      ],
      "description": "Media type of image_base64. Optional when image_base64 is a data URI."
    },
    "confirm": {
      "type": "boolean",
      "description": "false = preview only (default). true = save the cards of preview_id."
    },
    "apply": {
      "type": "boolean",
      "description": "Alias of confirm. Either one set to true saves the cards of preview_id."
    },
    "preview_id": {
      "type": "string",
      "description": "The preview_id from the preview call. Required when confirm is true."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "document_id": {
      "type": "integer",
      "description": "Id of the uploaded document that holds the statement."
    },
    "transactions": {
      "type": "array",
      "description": "Posted card transactions, as an alternative to document_id. Purchases are positive amounts; refunds and payments are negative.",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "YYYY-MM-DD"
          },
          "description": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "currency": {
            "type": "string",
            "description": "ISO code, e.g. USD."
          },
          "merchant": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        },
        "required": [
          "date",
          "description",
          "amount",
          "currency"
        ]
      }
    },
    "apply": {
      "type": "boolean",
      "description": "false = preview only (default). true = import the transactions of preview_id."
    },
    "preview_id": {
      "type": "string",
      "description": "The preview_id from the preview call. Required when apply is true."
    },
    "card_label": {
      "type": "string",
      "description": "Name of the card the statement is for, e.g. 'Amex Gold'. Optional."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO country code (US, GB, CA, AU, DE, ...). UK is accepted for GB. 'all' returns every country. Defaults to the user's primary country (US when unknown)."
    },
    "issuer": {
      "type": "string",
      "description": "Issuer name or key, for example 'amex', 'American Express' or 'Barclays'."
    },
    "query": {
      "type": "string",
      "description": "Text to match in the card name or slug."
    },
    "points_currency": {
      "type": "string",
      "description": "Points currency to match, for example 'Avios' or 'Qantas Points'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum cards to return. Default 25, maximum 100."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "active": {
      "type": "boolean",
      "description": "Only active alerts when true, only paused or expired alerts when false. Omit for all."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Departure airport IATA code"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Arrival airport IATA code"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Default economy"
    },
    "type": {
      "type": "string",
      "enum": [
        "all",
        "award",
        "cash"
      ],
      "description": "Default all"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Default 20"
    }
  },
  "required": [
    "origin",
    "destination",
    "date"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "type": "string",
      "description": "City, neighbourhood or landmark, e.g. 'Tokyo', 'Paris'"
    },
    "check_in_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "check_out_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "adults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Default 2"
    },
    "rooms": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "Default 1"
    },
    "min_rating": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "description": "Minimum guest review score out of 5"
    },
    "award_only": {
      "type": "boolean",
      "description": "Only Marriott/Hilton/Hyatt/IHG hotels with award nights for every night"
    },
    "max_price_usd": {
      "type": "number",
      "minimum": 1,
      "description": "Maximum total stay price in USD"
    },
    "premium_only": {
      "type": "boolean",
      "description": "Only hotels with FHR, Hotel Collection or Edit benefits"
    },
    "sort": {
      "type": "string",
      "enum": [
        "price",
        "rating",
        "points"
      ],
      "description": "Default price (cheapest first)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Default 20"
    }
  },
  "required": [
    "city",
    "check_in_date",
    "check_out_date"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "unread_only": {
      "type": "boolean",
      "description": "Only unread notifications. Defaults to false."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "How many to return. Defaults to 25."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "notification_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Notification ids from list_notifications."
    },
    "all": {
      "type": "boolean",
      "description": "Mark every unread notification as read."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "dry_run": {
      "type": "boolean",
      "description": "Preview only. Defaults to true. Pass false to apply the merge after the user confirms."
    },
    "program": {
      "type": "string",
      "description": "Optional: limit the cleanup to one programme (any slug or name)."
    }
  },
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin airport IATA code, e.g. 'LHR'."
    },
    "destination": {
      "type": "string",
      "description": "Destination airport IATA code, e.g. 'JFK'."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Travel date YYYY-MM-DD. Give this or month."
    },
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Travel month YYYY-MM (cached fares only)."
    },
    "cabin": {
      "type": "string",
      "description": "economy, premium, business, or first.",
      "default": "economy"
    },
    "goal_program": {
      "type": "string",
      "description": "Optional status programme slug, e.g. 'british-airways-executive-club'."
    },
    "goal_tier": {
      "type": "string",
      "description": "Optional goal tier, e.g. 'Gold'."
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "program": {
      "type": "string",
      "description": "Program name or slug. Supported: avios, british-airways."
    },
    "origin": {
      "type": "string",
      "description": "Origin city or IATA code. Only London is supported. Omit for London."
    },
    "destination": {
      "type": "string",
      "description": "Destination city or IATA code, e.g. Tokyo or JFK."
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "business"
      ],
      "description": "Optional cabin."
    }
  },
  "required": [
    "program",
    "destination"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "confirm": {
      "type": "boolean",
      "description": "Must be true to replace the link. Ask the user first."
    }
  },
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "card": {
      "type": "string",
      "description": "Card id from list_my_cards, or its name or nickname."
    },
    "permanent": {
      "type": "boolean",
      "description": "Delete the card entirely instead of marking it closed."
    }
  },
  "required": [
    "card"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "british_airways",
        "qatar_airways",
        "cathay_pacific",
        "virgin_atlantic",
        "iberia",
        "alaska_airlines",
        "american_airlines",
        "qantas",
        "jetblue",
        "frontier",
        "southwest",
        "delta",
        "etihad",
        "emirates",
        "japan_airlines",
        "united",
        "tap_portugal",
        "cape_air",
        "icelandair",
        "condor",
        "aer_lingus",
        "el_al",
        "turkish_airlines",
        "ana",
        "lufthansa",
        "air_france",
        "klm",
        "smiles",
        "qantas_rewards",
        "alaska_direct",
        "breeze",
        "aerolineas_argentinas",
        "virgin_atlantic_rewards",
        "cayman_airways",
        "virgin_australia",
        "air_canada",
        "aeromexico",
        "avianca_lifemiles",
        "sas_eurobonus",
        "starlux",
        "srilankan",
        "hainan",
        "jetstar",
        "singapore_airlines",
        "hong_kong_airlines"
      ]
    },
    "departure_code": {
      "type": "string",
      "description": "IATA code (LHR), or a city or airport name (Heathrow, Tokyo)"
    },
    "arrival_code": {
      "type": "string",
      "description": "IATA code (SIN), or a city or airport name"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin to unlock and rank by (default: economy). Results list EVERY bookable cabin the airline returned, not just this one — free accounts may only request economy."
    },
    "live": {
      "type": "boolean",
      "default": false,
      "description": "Run a live airline search when no stored result exists. Slower. Use only when the user needs fresh data."
    }
  },
  "required": [
    "airline",
    "departure_code",
    "arrival_code",
    "date"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "airline": {
      "type": "string",
      "enum": [
        "british_airways",
        "qatar_airways",
        "cathay_pacific",
        "virgin_atlantic",
        "iberia",
        "qantas",
        "qantas_rewards",
        "etihad",
        "smiles",
        "virgin_australia",
        "delta",
        "klm",
        "turkish_airlines",
        "lufthansa",
        "tap_portugal",
        "united",
        "emirates"
      ]
    },
    "departure_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "arrival_code": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$",
      "description": "Month to search (YYYY-MM or YYYY-MM-DD)"
    },
    "live": {
      "type": "boolean",
      "default": false,
      "description": "Run a live airline search when no stored result exists. Slower. Use only when the user needs fresh data."
    }
  },
  "required": [
    "airline",
    "departure_code",
    "arrival_code",
    "date"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "type": "string",
      "description": "Two-letter country code (US, GB, AU) or country name. UK maps to GB. Empty string clears the setting."
    }
  },
  "required": [
    "country"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "listed": {
      "type": "boolean",
      "description": "true joins or renames, false leaves."
    },
    "handle": {
      "type": "string",
      "description": "Public handle. Required when listed is true."
    }
  },
  "required": [
    "listed"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "origin": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Home airport IATA code, e.g. LHR"
    },
    "points_budget": {
      "type": "integer",
      "minimum": 1,
      "description": "Max total points for the round trip. Omit to use the user's saved balances."
    },
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Travel month, e.g. 2026-11"
    },
    "date_from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Earliest outbound date"
    },
    "date_to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Latest outbound date"
    },
    "trip_nights": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "Trip length in nights (default 7, +/- 2)"
    },
    "cabin": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "description": "Cabin (default economy)"
    },
    "vibes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "warm",
          "beach",
          "city",
          "ski",
          "food",
          "culture",
          "nature"
        ]
      },
      "description": "Any of: warm, beach, city, ski, food, culture, nature"
    },
    "max_stops": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3,
      "description": "Max stops. Cached calendar data has no stop count, so this is not applied."
    }
  },
  "required": [
    "origin"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "card": {
      "type": "string",
      "description": "Card id from list_my_cards, or its name or nickname."
    },
    "name": {
      "type": "string",
      "description": "New card name."
    },
    "nickname": {
      "type": "string",
      "description": "New nickname; empty string clears it."
    },
    "opened_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD; empty string clears it."
    },
    "closed_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD; empty string reopens the card."
    },
    "notes": {
      "type": "string",
      "description": "New notes; empty string clears them."
    },
    "bonus_amount": {
      "type": [
        "integer",
        "string"
      ],
      "description": "Welcome bonus size as a whole number, e.g. 80000. Empty string clears it."
    },
    "bonus_currency": {
      "type": "string",
      "description": "What the bonus is paid in, e.g. 'Chase Ultimate Rewards points', 'Amex Membership Rewards points' or 'cash back'."
    },
    "bonus_status": {
      "type": "string",
      "enum": [
        "pending",
        "earned",
        "missed",
        ""
      ],
      "description": "pending: the bonus is offered but the spend requirement is not met yet. earned: the bonus has posted (also set bonus_earned_on). missed: the deadline passed without it. Leave unset if unknown. Empty string clears it."
    },
    "bonus_earned_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD the bonus was earned; empty string clears it."
    },
    "spend_requirement": {
      "type": [
        "number",
        "string"
      ],
      "description": "Minimum spend to earn the bonus, in whole currency units (4000 means $4,000). Empty string clears it."
    },
    "spend_deadline_on": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD by which the spend requirement must be met; empty string clears it."
    },
    "spend_window_months": {
      "type": [
        "integer",
        "string"
      ],
      "enum": [
        1,
        2,
        3,
        6,
        12,
        "1",
        "2",
        "3",
        "6",
        "12",
        ""
      ],
      "description": "Months from the opened date to meet the spend requirement (1, 2, 3, 6 or 12). The server works out spend_deadline_on from opened_on. Used only when spend_deadline_on is not given; needs an opened date."
    },
    "annual_fee": {
      "type": [
        "number",
        "string"
      ],
      "description": "Annual fee in whole currency units (95 means $95). Empty string clears it."
    },
    "currency": {
      "type": "string",
      "description": "3-letter currency code for spend_requirement and annual_fee. Defaults to USD."
    },
    "country": {
      "type": "string",
      "description": "2-letter ISO country code of the card, for example GB, US, CA or AU (UK is accepted for GB). Catalogue cards use the catalogue country when this is not set. Empty string resets it to the catalogue country."
    }
  },
  "required": [
    "card"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "portfolio_id": {
      "type": "integer"
    },
    "client_name": {
      "type": "string"
    },
    "client_email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "balances": {
      "type": "object"
    },
    "preferences": {
      "type": "object"
    },
    "notes": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "archived"
      ]
    }
  },
  "required": [
    "portfolio_id"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "alert_id": {
      "type": "integer",
      "description": "Delay alert id from list_delay_alerts."
    },
    "airport": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "email",
          "sms",
          "whatsapp"
        ]
      }
    },
    "phone_number": {
      "type": "string"
    },
    "min_delay_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 600
    },
    "label": {
      "type": "string"
    },
    "active": {
      "type": "boolean",
      "description": "false pauses the alert, true resumes it."
    }
  },
  "required": [
    "alert_id"
  ],
  "type": "object"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "alert_id": {
      "type": "integer",
      "description": "Flight alert id from list_flight_alerts."
    },
    "airline": {
      "type": "string",
      "enum": [
        "BA",
        "VS",
        "CX",
        "IB",
        "QR",
        "EY",
        "JL",
        "B6",
        "UA",
        "TP",
        "HA",
        "FI"
      ]
    },
    "departure": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "destination": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "date_range_start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_range_end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "cabin_class": {
      "type": "string",
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ]
    },
    "active": {
      "type": "boolean",
      "description": "false pauses the alert, true resumes it."
    }
  },
  "required": [
    "alert_id"
  ],
  "type": "object"
}

Input schema

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

Input schema

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

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "program": {
      "type": "string",
      "description": "Canonical loyalty program slug. Reuse the slug shown by list_points_balances.",
      "enum": [
        "accor-all",
        "aegean-miles-bonus",
        "aer-lingus-aerclub",
        "air-canada-aeroplan",
        "air-france-klm-flying-blue",
        "air-india-maharaja-club",
        "air-new-zealand-koru",
        "alaska-atmos-rewards",
        "american-aadvantage",
        "amex-membership-rewards",
        "amex-membership-rewards-uk",
        "ana-mileage-club",
        "best-western-rewards",
        "bilt-rewards",
        "british-airways-executive-club",
        "capital-one-miles",
        "cathay-pacific-cathay",
        "chase-ultimate-rewards",
        "china-airlines-dynasty-flyer",
        "choice-privileges",
        "citi-thankyou-points",
        "delta-skymiles",
        "emirates-skywards",
        "etihad-guest",
        "eva-air-infinity-mileagelands",
        "finnair-plus",
        "frontier-miles",
        "garuda-indonesia-garudamiles",
        "hilton-honors",
        "iberia-club",
        "ihg-one-rewards",
        "jal-mileage-bank",
        "jetblue-trueblue",
        "korean-air-skypass",
        "lufthansa-miles-and-more",
        "malaysia-airlines-enrich",
        "marriott-bonvoy",
        "mea-cedar-miles",
        "meliarewards",
        "minor-discovery",
        "oman-air-sindbad",
        "philippine-airlines-mabuhay-miles",
        "qantas-frequent-flyer",
        "qatar-privilege-club",
        "radisson-rewards",
        "royal-jordanian-royal-club",
        "sas-eurobonus",
        "singapore-krisflyer",
        "southwest-rapid-rewards",
        "tap-miles-go",
        "thai-airways-royal-orchid-plus",
        "turkish-airlines-miles-and-smiles",
        "united-mileageplus",
        "velocity-frequent-flyer",
        "vietnam-airlines-lotusmiles",
        "virgin-atlantic-flying-club",
        "world-of-hyatt",
        "wyndham-rewards"
      ]
    },
    "balance": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50000000
    },
    "expires_on": {
      "type": "string",
      "format": "date",
      "description": "Optional expiry date of the points (YYYY-MM-DD), when the account page shows one."
    }
  },
  "required": [
    "program",
    "balance"
  ],
  "type": "object"
}

Input schema

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

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "voucher_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Voucher id from list_my_vouchers."
    },
    "expires_on": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Voucher expiry date (YYYY-MM-DD)."
    },
    "reference": {
      "type": "string",
      "description": "Voucher code or membership reference."
    },
    "notes": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "held",
        "applied",
        "used",
        "expired"
      ]
    }
  },
  "required": [
    "voucher_id"
  ],
  "type": "object"
}

Input schema

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

Input schema

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