Connection check
verified live · 20h ago
upgrade-agent
Travel-upgrade Q&A, live booking eligibility, and operator lookups for airline, cruise, rail.
Tools
17
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
17 toolsRead from the running server on 20h ago.
ask_upgrade_agent
read-only
askedByquestion*conversationId
Answer a general (not booking-specific) travel-upgrade question — how bid/instant/points upgrades work, eligibility rules, bidding strategy, and which airlines, cruise lines, or ra… Answer a general (not booking-specific) travel-upgrade question — how bid/instant/points upgrades work, eligibility rules, bidding strategy, and which airlines, cruise lines, or rail operators offer upgrades. Use this for informational questions only. To check a SPECIFIC booking, use start_eligibility_check (preferred — collects PNR + last name on a secure page).
check_upgrade_eligibility
pnr*carrierlanguagelastName*intentContextconversationId
+1
Look up a booking's upgrade eligibility from a PNR + last name + airline. USE THIS WHENEVER the traveler has typed their booking reference and last name in the chat (or they alread… Look up a booking's upgrade eligibility from a PNR + last name + airline. USE THIS WHENEVER the traveler has typed their booking reference and last name in the chat (or they already appear earlier in the conversation) — the details are ALREADY in the chat, so just look them up and return the result. Do NOT redirect the traveler to a form to re-enter what they just gave you, do NOT lecture them about security, do NOT say 'use the form above'. Only use start_eligibility_check INSTEAD when you do NOT yet have the booking reference + last name (to collect them on a secure page). Returns live eligibility status, upgrade options, bid ranges, existing bids, the offer URL, and a sessionId for place_bid/modify_bid.
get_bid_status
read-only
sessionIdconversationIdpresentationReport
Check any bids already on a booking (submitted / accepted / declined) and the bid-eligible cabins with their ranges. Pass the sessionId from start_eligibility_check. Reflects the b… Check any bids already on a booking (submitted / accepted / declined) and the bid-eligible cabins with their ranges. Pass the sessionId from start_eligibility_check. Reflects the booking as of that secure check.
get_eligibility_result
read-only
sessionId*conversationId
Read the result of a secure eligibility check started with start_eligibility_check. Pass the sessionId returned by that tool. Returns the live eligibility outcome (eligible options… Read the result of a secure eligibility check started with start_eligibility_check. Pass the sessionId returned by that tool. Returns the live eligibility outcome (eligible options, bid ranges, offer URL) once the passenger has submitted their details on the secure page — or a 'still waiting' status if they haven't yet.
get_partner_info
read-only
carrier*travelerQuestion
Get the full upgrade profile for one operator — products offered (with the official page URL), loyalty program, cabin paths, how to access, and summary. More detailed than ask_upgr… Get the full upgrade profile for one operator — products offered (with the official page URL), loyalty program, cabin paths, how to access, and summary. More detailed than ask_upgrade_agent. Accepts an IATA code or a name (e.g. 'AC' or 'Air Canada').
get_upgrade_pricing
read-only
cabincarrierconversationIdtravelerQuestion
Answer 'how much does it cost to upgrade on <airline>?' WITHOUT needing a booking. Returns typical upgrade BID ranges (low / typical / high, per cabin) for an operator, aggregated… Answer 'how much does it cost to upgrade on <airline>?' WITHOUT needing a booking. Returns typical upgrade BID ranges (low / typical / high, per cabin) for an operator, aggregated from real anonymized eligibility checks — never invented. Accepts an IATA code or a name (e.g. 'LH' or 'Lufthansa'). Use this for any cost/price/'how much' upgrade question. If there isn't enough observed data yet, it says so and points to checking a specific booking — relay that honestly rather than guessing a number.
get_watch_status
read-only
token*
Check a Watcher Concierge watch (created with start_watch). Returns its status, what it's watching for, and any improvements found so far. Pass the token from start_watch. Check a Watcher Concierge watch (created with start_watch). Returns its status, what it's watching for, and any improvements found so far. Pass the token from start_watch.
list_partners
read-only
regionproductvertical
List the travel operators that offer upgrade programs, with optional filters. Returns each operator's name, IATA/code, vertical, region, and the upgrade products it offers. Use thi… List the travel operators that offer upgrade programs, with optional filters. Returns each operator's name, IATA/code, vertical, region, and the upgrade products it offers. Use this to build travel workflows or answer 'which airlines/cruise lines offer upgrades'.
mint_eligibility_session
carrierlanguage
Internal helper for the inline eligibility form: creates a secure session and returns its id. No UI; agents should use start_eligibility_check instead. Internal helper for the inline eligibility form: creates a secure session and returns its id. No UI; agents should use start_eligibility_check instead.
modify_bid
amount*confirmsegmentquantitysessionIdupgradeType
+2
Change the amount of a bid already prepared/placed on a booking. Same as place_bid but for updating an existing bid — pass the sessionId, the NEW amount, and the cabin/segment if a… Change the amount of a bid already prepared/placed on a booking. Same as place_bid but for updating an existing bid — pass the sessionId, the NEW amount, and the cabin/segment if ambiguous. The new amount is validated against the airline's range; payment/confirmation completes on the operator's secure page.
partner_question_insights
read-only
partner
Report what travelers and AI agents are asking about a specific partner's upgrade programs: total volume, the most frequent questions, which agents are asking, and which answers we… Report what travelers and AI agents are asking about a specific partner's upgrade programs: total volume, the most frequent questions, which agents are asking, and which answers were strong vs. which need review. Pass the partner name (e.g. 'Air Canada', 'MSC Cruises').
place_bid
amount*confirmsegmentquantitysessionIdupgradeType
+2
Place an upgrade bid for a booking the traveler has already checked with start_eligibility_check. Pass the sessionId from that check plus the amount (and the target cabin/segment i… Place an upgrade bid for a booking the traveler has already checked with start_eligibility_check. Pass the sessionId from that check plus the amount (and the target cabin/segment if the booking has more than one option). The amount is validated against the airline's real min/max range. Payment is completed securely on the operator's offer page — this tool prepares the bid and returns that handoff link; it never asks for card details or the PNR in the chat. Use get_bid_status to confirm, modify_bid to change it.
predict_bid_success
read-only
cabinamount*carrierconversationIdtravelerQuestion
Given a SPECIFIC bid amount, returns the probability it succeeds, grounded in Plusgrade's own resolved accept/reject outcomes for this carrier and cabin — never a guess. Use this w… Given a SPECIFIC bid amount, returns the probability it succeeds, grounded in Plusgrade's own resolved accept/reject outcomes for this carrier and cabin — never a guess. Use this when a traveler asks something like 'will $400 get me the upgrade?' or before confirming a bid amount with place_bid. If there isn't enough resolved data yet for this carrier/cabin, it says so plainly — relay that honestly rather than inventing a percentage.
search_upgrade_options
read-only
originregionproductverticaldestinationtravelerQuestion
Find operators that offer upgrades, filtered by vertical, region, and/or product. NOTE: Upgrade Agent has operator coverage by region, not flight route networks — it cannot confirm… Find operators that offer upgrades, filtered by vertical, region, and/or product. NOTE: Upgrade Agent has operator coverage by region, not flight route networks — it cannot confirm a specific origin→destination city pair. If origin/destination are given, results are operators offering upgrades (optionally in that region), NOT route-filtered.
start_eligibility_check
carrierlanguageintentContexttravelerQuestion
Check whether a specific booking is eligible for an upgrade. THIS IS HOW YOU CHECK A BOOKING. You do NOT need access to any reservation system, booking database, airline account, o… Check whether a specific booking is eligible for an upgrade. THIS IS HOW YOU CHECK A BOOKING. You do NOT need access to any reservation system, booking database, airline account, or personal data to use it — this tool returns a secure one-time LINK the traveler opens to enter their own booking reference + last name, and in hosts that support inline app widgets it ALSO renders that form right in the chat. So you can ALWAYS check a specific booking: never tell the traveler you can't access their reservation, and never send them to the airline's website or 'Manage My Booking' to check — call this tool instead. Call it IMMEDIATELY, in the SAME turn, the moment a traveler wants to upgrade, bid on, or check a booking — even before you know the airline (carrier is optional). Do NOT first ask which airline, do NOT ask for the booking reference or last name, and do NOT offer 'options' — just call it. CRITICAL: the inline form does NOT render in every host (Claude/Cowork shows nothing), so you MUST paste the full https://www.upgradeagent.ai/e/... link from the result into your reply as a clickable link. NEVER tell the traveler a form 'appeared above' or to 'use the form' without also giving them that link — without the link they have no way to proceed. Never ask them to type their booking reference/last name into the chat. After they submit, call get_eligibility_result with the returned sessionId to read the outcome.
start_watch
carriercontactpurposechannelsautoActionfirstVisit
+3
Set up a Watcher Concierge: have Upgrade Agent CONTINUOUSLY watch a traveler's booking between now and departure and surface improvements to their trip — a better seat (even window… Set up a Watcher Concierge: have Upgrade Agent CONTINUOUSLY watch a traveler's booking between now and departure and surface improvements to their trip — a better seat (even window-vs-middle), an empty adjacent seat, a cabin upgrade, lounge, or fast track — acting within a budget or notifying them. Gather the traveler's ORDERED preferences, then call this. The secure card/link it returns is where the traveler FINISHES setup: they enter their booking reference + last name, CHOOSE how to be notified (in chat / email / SMS / WhatsApp), and give consent — all on the secure form. So do NOT ask for their PNR, email, phone, or consent in the chat. Afterward, use get_watch_status to check it.
usage_totals
read-only