Award Travel Finder Plugin

Search award flight availability, compare loyalty programs, and find the best points redemptions — all from Claude Code. This plugin connects to the Award Travel Finder MCP server to give Claude real-time access to award flight data across 19 airlines and 14 loyalty programs.

Works with Claude Code CLI, Claude Desktop, and any MCP-compatible client. Learn more at awardtravelfinder.com/claude.

Quick Install

Claude Code Plugin (recommended)

Inside Claude Code:

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

On first plugin use, Claude opens awardtravelfinder.com in your browser to sign you up via OAuth. Takes about 30 seconds — free, no credit card. Tokens auto-refresh after that.

Free tier: 50 searches/month per account. Paid tiers (150/month and up) at awardtravelfinder.com/pricing for power users.

Manual MCP Server Setup (Claude Desktop, Cursor, etc.)

Add to your MCP client config:

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

The server publishes /.well-known/oauth-authorization-server, so OAuth-aware clients sign you in on first call automatically. For clients without native OAuth, use npx mcp-remote https://mcp.awardtravelfinder.com/mcp.

X-API-Key (legacy / server-to-server)

Header-based auth is still supported for users who configured it pre-OAuth, or for agents that don't run a browser:

{
  "mcpServers": {
    "awardtravelfinder": {
      "type": "url",
      "url": "https://mcp.awardtravelfinder.com/mcp",
      "headers": {
        "X-API-Key": "atf_..."
      }
    }
  }
}

Generate a key at awardtravelfinder.com/pricing.

What You Can Do

Search Award Flights

Ask Claude naturally or use slash commands:

"Find business class from London to New York using Avios"
"Search for first class availability on Qatar Airways from Doha to Singapore in June"
"Pull a monthly calendar of LHR→HND business class for May 2027"
"Cheapest way to fly business JFK→NRT in November under 100k points?"

Or use the command:

/atf:search-flights BA LHR JFK 2026-06-15
/atf:search-flights qatar DOH SIN 2026-07

Compare Loyalty Programs

"Compare British Airways Avios vs Emirates Skywards for flights to Dubai"
"Which program has the cheapest business class to Tokyo?"
"For LHR→HND in business, compare Avios, Aeroplan, Flying Blue, and Virgin"

/atf:compare-programs british-airways emirates
/atf:compare-programs aeroplan flying-blue

Check Award Pricing

"How many Avios do I need for London to New York in business?"
"Show me the Qatar Airways award chart"

MCP Tools (21)

Verified against the live MCP server source.

Flight search

Tool	Description
search_availability	Award seats for one route + date across all supported airlines.
search_monthly_availability	Calendar view for a whole month, one airline. Up to 90s.
search_all_airlines	Fan out a single date across every supported airline at once.
search_hybrid	Cash + points side-by-side, with hub/connection logic for split-ticket journeys.
get_pricing	Price a route in any of 14 loyalty programs, including taxes and fuel surcharges.

Loyalty programs

Tool	Description
get_program_rates	Award chart for one program (zones, cabin pricing, partner rules).
get_buy_points_pricing	Current "buy miles" promotions, in case it's cheaper than redeeming.
get_status_matches	Which programs will status-match a given tier, and how long it lasts.

Hotels

Tool	Description
search_hotels	Find hotels by city/area for a date range.
get_hotel_availability	Award nights at a specific property.
monitor_hotel_price	Watch a property and ping you on price drops.
list_hotel_bookings	Track hotel award reservations.
get_hotel_booking	Fetch a single saved hotel booking.

Trip portfolio (per user)

Tool	Description
add_flight_booking / list_flight_bookings / get_flight_booking	Track flight bookings across programs.
update_flight_booking / delete_flight_booking	Edit or remove tracked bookings.
update_points_balance / list_points_balances / get_portfolio	Track miles balances and total portfolio value.

Supported Airlines (19)

Full availability and award charts for the airlines below. Some airlines (BA, Qatar, Cathay, Virgin, Iberia, Qantas) have full availability + monthly calendars; others (American, Alaska, JetBlue, Etihad, Emirates) have a subset.

Oneworld — British Airways (BA), Cathay Pacific (CX), Iberia (IB), Qatar Airways (QR), American Airlines (AA), Alaska Airlines (AS), Qantas (QF), Japan Airlines (JL)

SkyTeam — Air France / KLM, Korean Air

Star Alliance — Singapore Airlines, ANA, Turkish Airlines, Aeroplan / Air Canada

Non-aligned / partners — Virgin Atlantic (VS), Emirates (EK), Etihad (EY), JetBlue (B6), Frontier (F9)

Loyalty Programs (14)

Program	Slug	Currency
British Airways	british-airways	Avios
Iberia	iberia	Avios
Qatar Airways	qatar-airways	Avios
Aer Lingus	aer-lingus	Avios
Virgin Atlantic	virgin-atlantic	Virgin Points
Aeroplan	aeroplan	Aeroplan Points
Flying Blue	flying-blue	Flying Blue Miles
Cathay Pacific	cathay-pacific	Asia Miles
Singapore Airlines	singapore-airlines	KrisFlyer Miles
Emirates	emirates	Skywards Miles
Etihad	etihad	Guest Miles
Turkish Airlines	turkish-airlines	Miles & Smiles
ANA	ana	Mileage Club
JetBlue	jetblue	TrueBlue Points

Skills

This plugin includes an award-travel skill that activates automatically when you mention award flights, points, miles, loyalty programs, or specific airlines. No slash command needed — just ask Claude.

Plugin Structure

award-travel-finder-plugin/
  .claude-plugin/
    plugin.json          # Plugin metadata
    marketplace.json     # Marketplace listing
  .mcp.json              # MCP server connection config
  commands/
    search-flights.md    # /atf:search-flights command
    compare-programs.md  # /atf:compare-programs command
  skills/
    award-travel/
      SKILL.md           # AI skill for natural language queries
      references/
        airlines.md      # Airline reference data
        programs.md      # Loyalty program reference data

How It Works

This plugin connects Claude Code to the Award Travel Finder MCP server, which provides real-time award flight availability data. The MCP (Model Context Protocol) server runs on Cloudflare Workers and queries airline APIs to find available award seats. Some airlines are cached up to 4 hours to avoid bot-blocking; cached results are marked in the response.

Links

• Award Travel Finder for Claude Code — Plugin landing page with example prompts
• Award Travel Finder — Full web app
• MCP Server — API documentation
• Transfer Bonus Tracker — Current transfer bonuses with predictions
• Pricing — Free tier (50/mo) and paid tiers

License

MIT