Before you start
- • Active TravelMaxx subscription
- • Award search account linked in your account settings
Server URL
Use this URL in any MCP-compatible client. You'll be prompted to sign in and approve access.
https://mcp.travelmaxx.app/mcp
Claude Desktop
https://mcp.travelmaxx.app/mcpOr edit the config file directly
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"travelmaxx": {
"url": "https://mcp.travelmaxx.app/mcp"
}
}
}Claude Code
claude mcp add travelmaxx --transport streamable-http https://mcp.travelmaxx.app/mcp
ChatGPT
https://mcp.travelmaxx.app/mcpRequires ChatGPT Plus, Pro, or Team.
Cursor, Windsurf & others
Any MCP client works. Add https://mcp.travelmaxx.app/mcp as a streamable HTTP server and approve when prompted.
Tools
The MCP server exposes the same capabilities as the TravelMaxx assistant and the CLI — all three call the same handlers, so they stay in lockstep.
Search search_flights, search_date_range, skyview_search,
discover_fares, list_alerts, create_alert, delete_alert
Airline fares alaska_fares, alaska_calendar, jetblue_fares
Waitlists alaska_waitlist, alaska_recommend, alaska_history,
united_waitlist, united_recommend, united_history
Your profile get_profile, update_profile, update_points_balance,
update_home_airports, set_holder_preference
Itineraries manage_flights, manage_trip, booked_flights
Airline accounts alaska_account, delta_account, delta_companion
Booking book_flight
Reference lookup_card, lookup_program, transfer_options,
search_guides, get_guide, status_match, status_image,
web_searchReading accounts & booking (multi-turn)
alaska_account and book_flight drive a real browser session on the airline's site, so they answer with a next_action naming what the assistant must collect from you before calling again.
- • Verification codes. A fresh Alaska sign-in or a booking returns
ask_2fa_code. The assistant asks you to read the code the airline just texted you, then calls again with it. Codes and card security codes are never logged or stored. - • Alaska account data. Miles, elite tier and status progress, Million Miler progress, discount and companion-fare codes, vouchers, upgrade certificates, lounge membership, wallet transactions, mileage activity, and upcoming trips. Served from a snapshot up to 24 hours old unless the assistant asks for a fresh sign-in.
- • Delta reads through your paired Delta companion Chrome extension (
delta_companionpairs it), and a Delta booking stops at Delta's final review page — it never clicks buy. - • Bookingsteps through flight → sign-in → passenger → payment → purchase, and Alaska only buys after your explicit final approval. One booking at a time per account (a second start returns
inform_busy); searches are not limited that way and can still run in parallel. - • Logging points.
update_points_balancerecords every balance change as a points transaction, so “I just redeemed 60k SkyMiles” is enough.
Example prompts
Troubleshooting
Search returns no results
Check that your award search account is linked in settings. Try broadening your date range or adding more programs - an alliance shortcut like ONEWORLD, STAR_ALLIANCE, or SKYTEAM searches every member program at once.
Token or authorization errors
Disconnect TravelMaxx from your client and reconnect to get a fresh token.
“Booking in progress”
You already have a booking session open. Ask the assistant for its status and either finish or cancel it. Searches are unaffected.
Delta account reads fail
Delta requires the companion Chrome extension. Ask the assistant to pair it, then install it in the browser you use for Delta.
Tools not appearing
Restart your AI client or start a new conversation.
Prefer your terminal? Every one of these tools has a command in the TravelMaxx CLI.