{
  "markdown": "# Award Travel Finder — Claude Code Plugin & MCP Server\n\nSearch award flight availability, compare loyalty programs, and find the best points redemptions from your AI assistant. This plugin connects to the [Award Travel Finder](https://awardtravelfinder.com) MCP server, which exposes 127 award-travel tools over a single hosted endpoint.\n\n**Works with Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT, Grok, Antigravity, and any MCP-compatible client.**\n\n## Quick install\n\n### Claude Code plugin (recommended)\n\n```\n/plugin marketplace add AwardTravelFinder/mcp\n/plugin install award-travel-finder\n```\n\n### Gemini CLI / Antigravity\n\n```\ngemini extensions install https://github.com/AwardTravelFinder/mcp\n```\n\n### Any other MCP client\n\nPoint your client at the endpoint:\n\n```\nhttps://mcp.awardtravelfinder.com/mcp\n```\n\nFor clients that take a config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"awardtravelfinder\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.awardtravelfinder.com/mcp\"]\n    }\n  }\n}\n```\n\nClients with native remote-MCP support (Cursor, Windsurf, ChatGPT developer mode, Grok custom connectors) can use the URL directly without `mcp-remote`.\n\nPer-client setup guides: [awardtravelfinder.com/mcp](https://awardtravelfinder.com/mcp).\n\n## Authentication\n\nThe 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.\n\n> **Do not set an `Authorization` or `X-API-Key` header.** 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 the `headers` block from your config.\n\nA free account covers everyday trip planning. [Premium](https://awardtravelfinder.com/pricing) unlocks unlimited searches and every cabin.\n\n## What you can do\n\nAsk naturally — the bundled `award-travel` skill activates on its own when you mention award flights, points, miles, or an airline:\n\n```\n\"Find business class from London to New York using Avios\"\n\"Are there any award seats on Cathay Pacific HKG-LHR next month?\"\n\"Which program has the cheapest business class to Tokyo?\"\n\"How many Avios do I need for London to New York in business?\"\n```\n\nOr use the slash commands:\n\n```\n/atf:search-flights BA LHR JFK 2026-06-15\n/atf:compare-programs british-airways emirates\n```\n\n## Coverage\n\n**28 airlines** can be searched one at a time with `search_availability`:\n\nBritish 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).\n\n**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.\n\n**23 loyalty programs** have award-chart data via `get_program_rates`:\n\n`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`.\n\n**4 hotel programs** for award nights: Marriott, Hilton, IHG, Hyatt.\n\n## Tools\n\n127 tools in total. The most-used ones:\n\n| Tool | What it does |\n|------|--------------|\n| `search_availability` | Award seats for one airline, route and date |\n| `search_all_airlines` | Sweep the 9 fan-out airlines in one call |\n| `search_monthly_availability` | A whole month, day by day |\n| `search_hybrid` | Cash-and-points combinations |\n| `get_pricing` | Award-chart pricing for a route |\n| `get_program_rates` | The full award chart for a program |\n| `get_points_valuation` | What a currency is worth |\n| `find_transfer_paths` | Routes from your cards into a program |\n| `compare_transfer_options` | Which transfer gets you there cheapest |\n| `get_status_matches` | Elite status match opportunities |\n| `search_hotels` / `get_hotel_availability` | Award nights across the 4 hotel programs |\n| `get_portfolio` / `list_points_balances` | Your tracked balances |\n| `add_flight_booking` / `list_flight_bookings` | Your trip log |\n\nRun `tools/list` against the endpoint for the full catalogue — it answers without authentication, so you can inspect the server before signing in.\n\n## Repository structure\n\nThis 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.\n\n```\nmcp/\n  server.json            # Official MCP registry manifest\n  gemini-extension.json  # Gemini CLI / Antigravity extension manifest\n  .claude-plugin/\n    plugin.json          # Plugin metadata\n    marketplace.json     # Marketplace listing\n  .mcp.json              # MCP server connection config\n  logo.png               # 400x400 marketplace logo\n  llms-install.md        # Agent-readable setup steps\n  commands/\n    search-flights.md    # /atf:search-flights\n    compare-programs.md  # /atf:compare-programs\n  skills/\n    award-travel/        # Activates on award-travel questions\n  openclaw/\n    SKILL.md             # OpenClaw-flavoured variant of the same skill\n```\n\nThe MCP server itself is a hosted service at `mcp.awardtravelfinder.com`; this repo holds the manifests and client-facing docs, not the server implementation.\n\n## Links\n\n- [Award Travel Finder](https://awardtravelfinder.com) — the web app\n- [Setup guides for every client](https://awardtravelfinder.com/mcp)\n- [Transfer bonus tracker](https://awardtravelfinder.com/transfer-bonuses)\n- [Pricing](https://awardtravelfinder.com/pricing)\n\n## Support\n\nOpen an issue here, or email [support@awardtravelfinder.com](mailto:support@awardtravelfinder.com).\n\n## License\n\nMIT\n",
  "bytes": 6328,
  "sha": "d96138b6e06f8e10288964f24cbe2dcd4529d6d26d9ae05628170e3d38eec149",
  "repo_slug": "awardtravelfinder/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_awardtravelfinder_mcp_c7184472/readme"
}