Set up a traveler profile once so FlightClaw can book flights with AI that fit the user. The profile holds the user, companions, travel preferences, cards, points balances and trip history. recommend_flights uses these preferences to rank cheap flights for the person asking.
When to use
- First use: onboard the user and their companions.
- The user states a preference ("I never fly red-eyes", "aisle seat").
- The user adds a card or a points balance.
- The user asks about past trips, or gives feedback after a trip.
Prerequisites
Connect the FlightClaw hosted MCP server: https://mcp.flightclaw.com/mcp (streamable HTTP, OAuth sign-in). Nothing to install.
- Claude Code:
claude mcp add --transport http flightclaw https://mcp.flightclaw.com/mcp - Cursor: One-click install, or add
{"mcpServers":{"flightclaw":{"url":"https://mcp.flightclaw.com/mcp"}}}to~/.cursor/mcp.json - VS Code: One-click install, or
code --add-mcp '{"name":"flightclaw","type":"http","url":"https://mcp.flightclaw.com/mcp"}' - Claude (web / desktop): Settings > Connectors > Add custom connector > paste
https://mcp.flightclaw.com/mcp - ChatGPT: Settings > Apps & Connectors > Create (developer mode) > paste
https://mcp.flightclaw.com/mcp
If the FlightClaw tools are not available, ask the user to connect the server first.
Tool flow
Who you are
get_me: show the primary user (linked traveler, account email, home airports).set_me: setme_traveler(a saved traveler name), and optionalaccount_emailandhome_airports(array of IATA codes).
Travelers
save_traveler:name(short key),given_name,family_name; optionalborn_on,gender,title,email,phone_number,relationship,loyalty_programmes.list_travelers,get_traveler(byname),delete_traveler(byname).
Preferences
get_preferences: show saved preferences and learnings.set_preferences: patch any subset. Fields thatrecommend_flightsuses:cabin_rules(short-haul and long-haul cabin),preferred_airlines,avoid_airlines,depart_window,max_stops,redeye_ok,budget_sensitivity. Other preferences such as seat, baggage and meal can be saved too.
Cards and points
save_card:id,issuer,product; optionalnetwork,region,notes. This records which cards the user holds for points awareness. It never stores card numbers.list_cards,delete_card(byid).set_points_balance:programandbalance.list_pointsshows all balances.
Trips
log_trip: after a booking, recordroute,depart_date,travelers; optionalreturn_date,cabin,price,currency,order_id.list_trips,get_trip(byid).trips_followup: list completed trips that need feedback.record_trip_feedback:id,feedbackand optionallearnings(array). Lasting lessons fold into preferences.
Onboarding order
save_travelerfor the user, thenset_me.save_travelerfor each companion, andsave_groupif they travel together.set_preferenceswith one or two questions per message.- Optional:
save_cardandset_points_balance.
Rules
- Never ask for or save card numbers, CVCs or passwords.
save_cardstores only issuer and product. - Ask before you save personal data, and save only what the user gives.
- Confirm before
delete_traveler,delete_cardor other deletes. - When the user books, confirm before
create_checkoutand show the price including the fee (5% + $3, minimum $12). See the book-flight skill.
Example prompts
- "Set me up: I'm Jack Culpan, home airports LHR and LGW."
- "I prefer economy on short flights and business on long-haul, and I avoid Ryanair."
- "I have an Amex Platinum and 120,000 Avios."
- "Show my past trips."
- "The Lisbon trip was great but the layover was too short. Remember that."
Learn more at flightclaw.com.