Model Context Protocol

Award Travel Finder MCP

Search award flight availability across airlines directly from your AI assistant. Find the best redemptions in seconds.

Most users want the simpler /claude install path. It uses the Claude Code plugin with OAuth — one command, sign in with your Award Travel Finder account, done. No API key to manage.

This page is for advanced users manually configuring the MCP server in Claude Desktop, Cursor, or Windsurf with an API key.

Server URL

https://mcp.awardtravelfinder.com/mcp

Transport Streamable HTTP Version 0.4.0 Status Online

Setup

Get your API key from your dashboard (free for economy; upgrade for all cabins)
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",
        "--header", "Authorization:Bearer ${ATF_API_KEY}"
      ],
      "env": {
        "ATF_API_KEY": "your-api-key"
      }
    }
  }
}

5. Restart Claude Desktop. AwardTravelFinder tools will appear in the tools menu.

Run in your terminal:

claude mcp add awardtravelfinder \
  --transport streamable-http \
  -H "Authorization: Bearer your-api-key" \
  https://mcp.awardtravelfinder.com/mcp

Get your API key from your dashboard (free for economy; upgrade for all cabins)

Get your API key from your dashboard
Open Cursor Settings → MCP
Click + Add new global MCP server
Paste the following:

{
  "mcpServers": {
    "awardtravelfinder": {
      "url": "https://mcp.awardtravelfinder.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Get your API key from your dashboard
Open Windsurf Settings → Cascade → MCP
Click Add Server → Add custom server
Add the following:

{
  "mcpServers": {
    "awardtravelfinder": {
      "serverUrl": "https://mcp.awardtravelfinder.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

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?"

Monthly API Limits

Each tool call (search, pricing lookup, etc.) counts as one API call. Limits reset monthly.

Pro

150

calls / month

All cabin classes

Enterprise

500

calls / month

All cabin classes + CORS

A free Award Travel Finder account gets you 5 economy searches/day. Paid tiers unlock 150/mo and 500/mo across every cabin.