Travel Hacking Toolkit: AI Award Flight Search and Points Optimization for Claude Code

What the Toolkit Does and Who It Is For

The Travel Hacking Toolkit is a plugin for AI coding agents that adds travel search capabilities to a conversational workflow. The README describes the core capability: ask your AI to find a 60,000-mile business class flight to Tokyo, and it searches award availability across 27 mileage programs, compares against cash prices, checks loyalty balances, and returns a recommendation.

The target users are frequent travelers who already use Claude Code, Codex, or OpenCode as their primary coding agent and want to query award availability, compare points and cash values, and track loyalty balances without switching to a separate app or website. The toolkit is not a standalone application; it extends an existing AI agent session with 42 travel skills and 6 MCP servers.

The included MCP servers cover flights (Skiplagged for cash search, Duffel for GDS real-fare-class prices, Ignav as a backup), hotels (Trivago, LiteAPI), transportation (Ferryhopper), accommodations (Airbnb), and loyalty tracking (AwardWallet for balances and elite status). A `travel-hacker` subagent is also included.

Installing via Claude Code Plugin

The plugin install for Claude Code is two commands run inside Claude Code:

/plugin marketplace add borski/travel-hacking-toolkit
/plugin install travel-hacker@borski

This installs 42 skills, the 6 MCP servers, and the travel-hacker subagent. To verify the install:

claude plugin list | grep travel-hacker

Running `/travel-hacker:getting-started` inside Claude Code shows which API keys are configured and points to the local setup script for missing ones.

For Codex, the install is a single terminal command:

codex plugin marketplace add borski/travel-hacking-toolkit

Cowork (Claude Desktop's agent panel) does not expose plugin slash commands, so it picks up the plugin automatically after a Claude Code install because both share `~/.claude/plugins/`. Claude Desktop's chat UI does not yet support the plugin format.

OpenCode users and contributors clone the repository instead:

git clone https://github.com/borski/travel-hacking-toolkit.git
cd travel-hacking-toolkit
./scripts/setup.sh

The setup script picks the target tool, creates the API key config file, installs dependencies, and optionally installs skills system-wide.

Free vs. Paid: Which APIs You Need

Five of the six MCP servers (Skiplagged, Kiwi, Trivago, Ferryhopper, Airbnb) work immediately after install with no API keys. Cash flight and hotel search work out of the box.

Award search requires paying for API access. The README identifies the four highest-value keys:

export SEATS_AERO_API_KEY="your-key-here"
export DUFFEL_API_KEY_LIVE="your-key-here"
export IGNAV_API_KEY="your-key-here"
export AWARDWALLET_API_KEY="your-key-here"
export AWARDWALLET_USER_ID="your-user-id"

Seats.aero is the main event for award search: it covers availability across 27 mileage programs and costs approximately $8 per month for the Pro plan according to the README table. Duffel provides real GDS cash prices and is free to search with payment only on booking. Ignav offers 1,000 free requests per month as a backup cash price source. AwardWallet requires a Business account to access the API and provides loyalty balance and elite status data.

The README notes that keys go in the shell environment because the plugin's userConfig mechanism does not propagate to skills that shell out to scripts. The setup script writes them to the shell rc file with masked input and single-quoting to handle metacharacters safely. If you store secrets in 1Password, the README shows how to use `op run` with the `--no-masking` flag (required because 1Password's default masking interferes with Claude Code's TTY detection).

Docker-Based Skills for Sites Without Public APIs

Five skills use Docker to interact with sites that do not expose public APIs: Southwest Airlines, American Airlines, Chase portal, Amex portal, and TicketsAtWork. These auto-pull their container images on first use. The toolkit includes a shared base image for these skills.

This approach means a Docker installation is a prerequisite for anyone who wants Southwest or American Airlines award data. The README mentions a shared base image, suggesting the five containers share a common dependency layer rather than each downloading independently.

The `.env.example` in the repository root lists the environment variable slots for each of these services alongside the standard API keys, so configuration follows the same pattern as the REST API keys.

Limitations: API Costs, Docker Dependency, and Key Management

The toolkit has several practical constraints to evaluate before committing.

Award search at scale costs money. Seats.aero's Pro plan is the primary dependency for the core feature. Free-tier or trial usage is not documented in the README for Seats.aero. Teams that want award search across all 27 programs without a monthly subscription cannot use the primary award search capability.

Browser-based skills for Southwest, American Airlines, Chase, and Amex require Docker to be installed and running. For users who do not already have Docker in their workflow, this is an additional dependency.

Key management is a manual process despite the setup script. The setup script writes keys to the shell rc file with a backup, but key rotation, expiry, and multi-user environments are not addressed in the README. The README acknowledges an upstream Claude Code bug that prevents plugin userConfig from propagating to skills that shell out, so environment variables in the shell rc file remain the required mechanism.

The free alternative for a subset of the functionality is flying point-of-sale award search on individual mileage program websites, or using Google Flights for cash price comparison. Neither automates the multi-program sweep that Seats.aero provides.

Maintenance and License

The last push to the repository was on 2026-09-21, seven days before this writing. The MIT license covers the toolkit code. Third-party APIs each carry their own terms and rate limits: Seats.aero, Duffel, Ignav, AwardWallet, SerpAPI, RapidAPI, LiteAPI, TripAdvisor, Entur, and ResRobot all have independent signup requirements documented in the README's API key reference section. The repository has no GitHub releases as of the last push date.

Editorial conclusion

The Travel Hacking Toolkit is the right choice for frequent travelers who already use Claude Code, Codex, or OpenCode and want award flight search and loyalty balance tracking integrated into their AI assistant workflow. The five free MCP servers cover cash flights and hotels immediately on install. The main event, award availability across 27 mileage programs, requires a Seats.aero Pro account at around $8 per month. Teams or individuals who do not want to manage API keys or run Docker for the browser-based skills should evaluate whether the savings from award optimization justify the setup cost. The MIT license covers the toolkit code; each third-party API and model carries its own terms.

Frequently asked questions

Official sources

1. borski/travel-hacking-toolkit on GitHub
2. Issues
3. License: MIT
4. README