Setup Guide

Connect TravelMaxx

Give your AI assistant access to award flight search, your loyalty profile, your live airline accounts, and award booking.

Before you start

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

1
Settings → Integrations → Add Integration
2
Paste the server URL: https://mcp.travelmaxx.app/mcp
3
Approve the connection in the browser window that opens.
Or edit the config file directly

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "travelmaxx": {
      "url": "https://mcp.travelmaxx.app/mcp"
    }
  }
}

Claude Code

1
Run this in your terminal:
claude mcp add travelmaxx --transport streamable-http https://mcp.travelmaxx.app/mcp
2
Approve the connection in the browser, then start a new session.

ChatGPT

1
Settings → Connectors → Add Connector
2
Paste the server URL: https://mcp.travelmaxx.app/mcp
3
Approve the connection, then start a new chat.

Requires 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_search

Reading 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

Find business class award flights from SFO to Tokyo in November.
Search JFK to London first class next week using Alaska or Virgin Atlantic miles.
What's in my Alaska account - any companion fares or upgrade certificates left?
How far am I from Million Miler?
Book me on AS1042 SEA to SFO on December 1 in business.
I redeemed 60k SkyMiles for that Paris flight - update my balance.
Alert me when business class JFK to NRT drops under 80k points.

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.

© 2026 TravelMaxx