The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Award Travel Finder listing page.
Search award flight availability, compare loyalty programs, and find the best points redemptions from your AI assistant. This plugin connects to the Award Travel Finder MCP server, which exposes 127 award-travel tools over a single hosted endpoint.
Works with Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT, Grok, Antigravity, and any MCP-compatible client.
Point your client at the endpoint:
For clients that take a config file:
Clients with native remote-MCP support (Cursor, Windsurf, ChatGPT developer mode, Grok custom connectors) can use the URL directly without mcp-remote.
Per-client setup guides: awardtravelfinder.com/mcp.
The server uses OAuth 2.1 as the MCP spec describes. On your first tool call the client opens your browser to sign in — about 30 seconds, no card. There is no API key.
Do not set an
AuthorizationorX-API-Keyheader. API-key authentication was retired on 2026-06-07. A leftover static header overrides the OAuth token the client obtained, and every request then fails with 401 even though the sign-in appeared to succeed. If you followed an older version of these instructions, delete theheadersblock from your config.
A free account covers everyday trip planning. Premium unlocks unlimited searches and every cabin.
Ask naturally — the bundled award-travel skill activates on its own when you mention award flights, points, miles, or an airline:
Or use the slash commands:
28 airlines can be searched one at a time with search_availability:
British Airways, Qatar Airways, Cathay Pacific, Virgin Atlantic, Iberia, Emirates, Qantas, Alaska Airlines, American Airlines, JetBlue, Frontier, Southwest, Delta, Japan Airlines, United, TAP Portugal, Cape Air, Icelandair, Condor, Aer Lingus, El Al, Turkish Airlines, ANA, Lufthansa, Air France, KLM, Etihad, Smiles (GOL).
11 of those are in the search_all_airlines fan-out, which sweeps them together in one call: British Airways, Cathay Pacific, Virgin Atlantic, Iberia, Qatar Airways, Alaska Airlines, JetBlue, Frontier, Southwest, Qantas, Smiles (GOL). Award inventory is genuinely sparse, so a route with no results usually means no seats rather than a broken search.
23 loyalty programs have award-chart data via get_program_rates:
british-airways, qatar-airways, singapore-airlines, cathay-pacific, emirates, etihad, flying-blue, aeroplan, turkish-airlines, ana, jetblue, jet2-emirates, virgin-atlantic, iberia, alaska-airlines, american-airlines, qantas, delta-skymiles, united, lifemiles, marriott-bonvoy, hilton-honors, hyatt.
4 hotel programs for award nights: Marriott, Hilton, IHG, Hyatt.
127 tools in total. The most-used ones:
| Tool | What it does |
|---|---|
search_availability | Award seats for one airline, route and date |
search_all_airlines | Sweep the 9 fan-out airlines in one call |
search_monthly_availability | A whole month, day by day |
search_hybrid | Cash-and-points combinations |
get_pricing | Award-chart pricing for a route |
get_program_rates | The full award chart for a program |
get_points_valuation | What a currency is worth |
find_transfer_paths | Routes from your cards into a program |
compare_transfer_options | Which transfer gets you there cheapest |
get_status_matches | Elite status match opportunities |
search_hotels / get_hotel_availability | Award nights across the 4 hotel programs |
get_portfolio / list_points_balances | Your tracked balances |
add_flight_booking / list_flight_bookings | Your trip log |
Run tools/list against the endpoint for the full catalogue — it answers without authentication, so you can inspect the server before signing in.
This repo is the public home for every Award Travel Finder AI and MCP surface — the Claude Code plugin, the MCP server manifest we publish to the official registry, and the metadata directories index.
The MCP server itself is a hosted service at mcp.awardtravelfinder.com; this repo holds the manifests and client-facing docs, not the server implementation.
Open an issue here, or email support@awardtravelfinder.com.
MIT