Model Context Protocol · Streamable HTTP · v0.4

The AI Award Travel Brain — over MCP.

Wire ATF's persistent memory and agent into your own client. One sign-in across cards, loyalty accounts, search tools, and folios — accessible over the open MCP protocol that Claude, ChatGPT, Cursor, and Windsurf already speak.

Install in your client → Plugin source on GitHub

Live in Claude Code, Claude Desktop, Cursor, and Windsurf over open MCP.

Server URL

https://mcp.awardtravelfinder.com/mcp

Transport Streamable HTTP Version 0.4.0 Status Online

Setup

Ensure Node.js is installed (needed to run the MCP bridge)
Open Settings → Developer → Edit Config
Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "awardtravelfinder": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.awardtravelfinder.com/mcp"
      ]
    }
  }
}

4. Restart Claude Desktop. Your browser opens to sign in (free, no card) — after you authorize, AwardTravelFinder tools appear in the tools menu. No API key needed; don’t add an Authorization or X-API-Key header — the endpoint authenticates via OAuth only, and a leftover key header will block the connection.

Recommended: install the free Claude Code plugin — OAuth in your browser, no API key to manage.

/plugin marketplace add jackculpan/award-travel-finder-plugin
/plugin install award-travel-finder

On first use, Claude opens your browser to sign you up — 30 seconds, no card. Free: 5 economy searches/day.

Or add the server manually — Claude Code runs the OAuth flow in your browser on first use:

claude mcp add awardtravelfinder \
  --transport http \
  https://mcp.awardtravelfinder.com/mcp

No API key needed — don’t pass an -H Authorization/X-API-Key header. The endpoint is OAuth-only; a leftover key header overrides the OAuth token and returns 401. Free for economy; upgrade for all cabins.

Open Cursor Settings → MCP
Click + Add new global MCP server
Paste the following:

{
  "mcpServers": {
    "awardtravelfinder": {
      "url": "https://mcp.awardtravelfinder.com/mcp"
    }
  }
}

Cursor opens your browser to sign in on first use. No API key or headers block needed — the endpoint is OAuth-only.

Open Windsurf Settings → Cascade → MCP
Click Add Server → Add custom server
Add the following:

{
  "mcpServers": {
    "awardtravelfinder": {
      "serverUrl": "https://mcp.awardtravelfinder.com/mcp"
    }
  }
}

Windsurf opens your browser to sign in on first use. No API key or headers block needed — the endpoint is OAuth-only.

Available tools

search_availability

Search award flight availability for a specific airline, route, and date. Returns seat availability by cabin class with points costs.

BA QR CX

search_monthly_availability

Search availability for an entire month. Returns day-by-day availability across all cabin classes — great for finding the best dates.

get_pricing

Get the award pricing chart for a route. Shows points required for each cabin class including off-peak and peak pricing.

get_airports

Get all airports served by a specific airline. Useful for checking if a route exists before searching.

list_programs

List all loyalty programs with award chart data. Returns program names, currencies, hubs, and destination counts.

get_program_rates

Get the full award chart for a loyalty program. All destinations with points per cabin class, off-peak and peak.

list_supported_airlines

List all airlines available for award flight search with their codes and supported endpoints.

Try it

Ask your AI assistant:

"Find BA business class availability from LHR to JFK on March 15th"
"Show me Qatar Airways award availability for the whole of April, DOH to SIN"
"How many Avios do I need for London to New York in first class?"
"What airports does Cathay Pacific fly to?"

Why install this

30-second signup

Install in your AI client, ask a question. On first use Claude opens your browser and you sign up at awardtravelfinder.com — no credit card, no waitlist. Free: 5 economy searches/day.

Monthly calendars in one prompt

Most flight tools make you click through 30 dates one at a time. Ask for "May 2027 LHR→HND in business" and you get the whole month back as a table.

Every program, one comparison

Same route, priced in Avios + Aeroplan + Flying Blue + Virgin in a single response — taxes and fuel surcharges included. The "is this actually a good deal?" question, in 8 seconds.

Live data, not training-data guesses

AI on its own will hallucinate award charts and quote rates from 2019. The MCP server replaces guesses with real availability and current pricing.

Plans

Same MCP endpoint, two tiers. Upgrade in one click — cancel anytime.

Free

5 economy searches/day

All guides & award charts

Premium

$9.99/mo

Unlimited searches · all cabins

Every integration · cancel anytime

Need higher API volume or commercial use? Contact us →

FAQ

Do I need an API key? +

No — every client signs you in with OAuth in your browser; there's no API key to copy or paste. The Claude Code plugin and manual setups for Claude Desktop, Cursor, and Windsurf all open awardtravelfinder.com on first use to sign you up in about 30 seconds. Free accounts get 5 economy searches per day — enough for normal trip planning. Need more? Upgrade to Premium.

Is it really free? +

Yes. The MCP server and Claude Code plugin are free. The free tier gives you 5 economy searches per day after signup. Premium $9.99/mo unlocks unlimited searches, all cabins, and every integration — cancel anytime.

What about my data? +

Your integrations are yours. We use OAuth for connected accounts — you can revoke any time and we never see your password. Searches are tied to your awardtravelfinder.com account so we can count them against your daily quota — that's it. We don't scrape your other AI conversations, files, or anything outside the MCP tool calls.

Which AI clients does this work in? +

The MCP endpoint at https://mcp.awardtravelfinder.com/mcp follows the open Model Context Protocol spec, so any client that supports remote MCP servers works — Claude Code (via the one-command plugin), Claude Desktop, Cursor, Windsurf, and ChatGPT's MCP support as it rolls out. Setup guides for each are in the Setup section above.

What about point.me, Roame, or other tools? +

We're the open, agent-native layer on top of award search. point.me is closed; we're not. Roame has AI branding but no real conversational agent. We're MCP-first and BYOK so you own your data and can switch backends anytime.

How accurate is the data? +

We pull live availability from each backend on most queries — same data you'd see directly. Some queries are cached for up to 4 hours to avoid rate-limiting; we mark cached results in the response. Award chart pricing is maintained by us and audited weekly. When a backend goes down we surface that in the tool output instead of returning silently wrong data.

How do I report a bug or request an integration? +

Open an issue at github.com/jackculpan/award-travel-finder-plugin or email [email protected]. Integration requests are tracked publicly — we ship one or two a month based on demand.

Free accounts get 5 economy searches/day. Premium $9.99/mo unlocks unlimited searches and all cabins.