Help / Connect an AI assistant

Connect an AI assistant

Claude and ChatGPT can read the balances you saved to AwardMath and plan a trip with the same solver the site runs. Setup is one link, copied from My Trips.

What you need

An AwardMath account, which is a confirmed email address and nothing else. Sign in at My Trips first, because the connector link is created there.

Get your connector link

  1. Go to awardmath.com/my-trips.
  2. Sign in with your email. We send a magic link; open it and you are in.
  3. Find the card called “Connect an AI assistant”.
  4. Create your connector link, then copy the URL.

The URL looks like https://awardmath.com/api/mcp/YOUR-KEY.

Keep the link to yourself

The URL contains your key. Anyone holding it can read your saved balances and trips, and can save new trips to your account. Treat it like a password.

You can rotate the key or disconnect it at any time from the same card on My Trips.

Claude (claude.ai)

Open Settings, then Connectors, then Add custom connector, and paste the URL. There is no separate sign-in step: the link carries your key.

Claude Code

Run this in your terminal, with your own URL in the quotes:

claude mcp add --transport http awardmath "YOUR-URL"

ChatGPT

Open Settings, then Connectors, and add the URL as a remote MCP server with authentication set to none. You may need to turn on developer mode before that option appears.

What the assistant can do

Four tools arrive with the connection.

  • get_wallet

    Reads your saved balances, trips, and watches.

  • plan_award_trip

    Plans a trip with the same deterministic solver the site runs, against your saved balances or against balances you type into the chat. It returns up to three plans and a live link to view them on AwardMath.

  • save_trip

    Saves a planned trip to My Trips.

  • program_facts

    Transfer partners and award chart rows for one program, each with its verification tier and the date it was observed.

What it does not do

It never books anything and never moves points. It cannot see card or airline logins, because AwardMath does not hold any. Every plan carries the date each number was observed, and award seats have to be confirmed with the airline at booking.

Run it from source

The open-source awardmath-mcp server wraps the public solver, program list, and wallet parser, with no key or account required, and runs locally over stdio. Unlike the personal, keyed connector above, it is stateless and knows nothing about you or your wallet. The repo also includes a free CC BY dataset with current verified transfer ratios and a handful of worked solver scenarios.

What asking looks like

“What’s the smartest way to Lisbon in business with what’s in my AwardMath wallet?”

The assistant reads your wallet, runs the solver, and comes back with up to three plans: which program to book through, how many points to move and from where, what the cash side costs, and when each number was checked. Ask it to save the one you want and it shows up in My Trips. Then confirm the seat with the airline before you transfer anything.

For the wider picture of what assistants get right and wrong with points, read Planning Award Travel With AI: ChatGPT, Claude, and MCP Connectors.