Model Context Protocol

Award Travel Finder MCP

Search award flights directly from your AI assistant. Uniform response format across all airlines. No API key needed — 10 free economy searches/month. Upgrade for more calls and all cabin classes.

Server URL
https://mcp.awardtravelfinder.com/mcp
Transport Streamable HTTP
Version 2.0.0
Status Online
Setup
Claude Desktop
  1. Works without an API key (10 economy searches/month). For more calls or all cabins, get a key from your dashboard
  2. Ensure Node.js is installed (needed to run the MCP bridge)
  3. Open Settings → Developer → Edit Config
  4. Add to your claude_desktop_config.json:
{
  "mcpServers": {
    "awardtravelfinder": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.awardtravelfinder.com/mcp",
        "--header", "X-API-Key:${ATF_API_KEY}"
      ],
      "env": {
        "ATF_API_KEY": "your-api-key-or-omit-for-free-tier"
      }
    }
  }
}
  1. Restart Claude Desktop. AwardTravelFinder tools will appear in the tools menu.
Claude Code (CLI)

Run in your terminal (works without API key — 10 free economy searches/month):

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

For more calls or all cabins, add -H "X-API-Key: your-key". Get your key from your dashboard

Cursor
  1. Works without an API key (10 economy searches/month). For more calls or all cabins, get a key from your dashboard
  2. Open Cursor Settings → MCP
  3. Click + Add new global MCP server
  4. Paste the following:
{
  "mcpServers": {
    "awardtravelfinder": {
      "url": "https://mcp.awardtravelfinder.com/mcp"
    }
  }
}
Windsurf
  1. Works without an API key (10 economy searches/month). For more calls or all cabins, get a key from your dashboard
  2. Open Windsurf Settings → Cascade → MCP
  3. Click Add Server → Add custom server
  4. Add the following:
{
  "mcpServers": {
    "awardtravelfinder": {
      "serverUrl": "https://mcp.awardtravelfinder.com/mcp"
    }
  }
}
Available Tools

10 tools — 4 freemium flight search, 1 public reference, 1 public status match, 4 auth-gated hotel monitoring

search_all_airlines
Search award flights across all supported airlines in parallel for a route and date. The recommended starting point — returns combined results from every airline that flies the route.
BAQRCXASAA
search_availability
Search award flight availability for a specific airline, route, and date. Use when you need a particular airline.
BAQRCXVSIBASAAQF
search_monthly_availability
Search availability for an entire month. Returns day-by-day availability rendered as an interactive rate calendar with points prices per date.
BAQRCXVSIBASAAQF
get_pricing
Get the award pricing chart for a route. Shows points required per cabin class with off-peak/peak pricing. No date needed.
BAQRCXVSIBEKQF
get_program_rates
Get the full award chart for a loyalty program. All destinations with points per cabin class, off-peak and peak. Public, no auth needed.
get_status_matches
Get current airline status match offers — match your elite status from one airline to another. Includes direct apply links and detailed FAQ pages. Filter by alliance (SkyTeam, Star Alliance, oneworld).
Flying BlueEtihadLufthansaTAPFrontier+10 more
search_hotels
Search hotels by name, city, or brand. Requires API key.
MarriottHiltonIHG
get_hotel_availability
Get current points rates for a hotel on specific dates. Triggers a live scrape. Requires API key.
monitor_hotel_price
Start monitoring a hotel booking for points price drops. Checks every 12 hours, sends email alerts. Requires API key.
list_hotel_bookings / get_hotel_booking
View tracked bookings and full price history. Requires API key.
Booking Tracker & Portfolio

Track your award bookings, points balances, and travel portfolio. Combine with Gmail MCP to automatically import bookings from confirmation emails.

add_flight_booking
Log an award flight redemption — airline, route, points, cabin class, confirmation number. Requires API key.
list_flight_bookings / get_flight_booking
View all tracked flight bookings with points spent and trip details. Requires API key.
update_flight_booking / delete_flight_booking
Update booking details or cancel a tracked flight. Requires API key.
update_points_balance
Set your current points/miles balance for any loyalty program. Creates or updates. Requires API key.
list_points_balances
View all your loyalty program balances in one place. Requires API key.
get_portfolio
Full portfolio summary — balances, spending, upcoming trips, destinations, monthly trends. Requires API key.
Response Format

All responses use a uniform cabins object with four canonical keys. Each cabin always returns the full object — never omitted, never false. Check response_type to determine the shape.

Cabin Object (uniform across all endpoints)
{ "available": true,  "seats": 5, "points": 26000, "taxes": 1, "taxes_currency": "GBP" }
{ "available": false, "seats": 0, "points": null,  "taxes": null, "taxes_currency": null }
Daily Availability
{ "response_type": "flights",
  "route": "DOH -> JFK", "search_date": "2026-03-15",
  "flights": [{
    "segments": [{ "flight_number": "QR701", "from": "DOH", "to": "JFK", ... }],
    "cabins": {
      "economy": { ... }, "premium_economy": { ... },
      "business": { ... }, "first": { ... }
    },
    "duration": "13h 30m", "overnight": false
  }]
}
{ "response_type": "calendar",
  "route": "LHR -> JFK", "search_date": "2026-03-15",
  "availability": {
    "date": "2026-03-15",
    "cabins": {
      "economy": { ... }, "premium_economy": { ... },
      "business": { ... }, "first": { ... }
    },
    "peak": false
  }
}
Monthly Availability (all airlines)
{ "route": "LHR -> JFK", "month": "March 2026",
  "availability": [
    { "date": "2026-03-01", "cabins": { "economy": { ... }, ... }, "peak": false },
    ...
  ]
}
Pricing (all airlines)
{ "route": "LHR -> JFK", "currency": "Avios",
  "pricing": {
    "economy":         { "off_peak": 26000, "peak": 32500, "taxes_off_peak": 1, "taxes_peak": 1 },
    "premium_economy": { ... }, "business": { ... }, "first": { ... }
  }
}
Try It

Ask your AI assistant:

AwardTravelFinder Pricing About MCP
AwardTravelFinder © 1970