travel-hacking-toolkit  by borski

AI travel toolkit for optimizing bookings

Created 3 weeks ago

New!

378 stars

Top 75.2% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

AI-powered travel hacking is addressed by this toolkit, enabling users of OpenCode and Claude Code to find award flights, compare points vs. cash, and manage loyalty programs. It provides drop-in skills and MCP servers to automate complex travel research, offering significant benefits for optimizing travel rewards.

How It Works

The toolkit integrates AI agents with real-time travel data through two primary mechanisms: Skills and MCP Servers. Skills are markdown files that define API interactions, teaching the AI how to call various travel services. MCP (Model Context Protocol) servers provide the AI with direct access to real-time tools. This architecture allows the AI to perform sophisticated tasks such as searching award availability across numerous programs, comparing cash prices, checking loyalty balances, and identifying optimal redemption strategies.

Quick Start & Requirements

Installation is initiated via a bash script:

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

The setup.sh script guides users through selecting their AI tool (OpenCode, Claude Code, or both), configuring API keys, and installing dependencies. Five MCP servers (Skiplagged, Kiwi, Trivago, Ferryhopper, Airbnb) function immediately without API keys. For full functionality, essential API keys include SEATS_AERO_API_KEY for award flight searches (paid, ~$8/mo) and SERPAPI_API_KEY for cash price comparisons (free tier available). Launch the tool using OpenCode opencode or Claude Code claude --strict-mcp-config --mcp-config .mcp.json.

Highlighted Details

  • Searches award flight availability across 25+ mileage programs via the Seats.aero skill.
  • Includes five free, immediately usable MCP servers: Skiplagged (hidden city fares), Kiwi.com (virtual interlining), Trivago (hotels), Ferryhopper (ferries), and Airbnb.
  • Provides comprehensive data files covering airline alliances, hotel chains, partner awards, points valuations, sweet spots, and transfer partners.
  • Skills cover a broad spectrum of travel needs, from flight and hotel searches to niche services like Nordic transit and Atlas Obscura hidden gems.

Licensing & Compatibility

The project is licensed under the MIT license. This permissive license generally allows for commercial use and integration with closed-source projects without significant restrictions.

Limitations & Caveats

A known issue with Claude Code suggests using the --strict-mcp-config flag for reliable MCP server loading, indicating potential instability with auto-discovery. Furthermore, accessing core features like comprehensive award flight searches requires a paid subscription to services such as Seats.aero.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
7
Issues (30d)
1
Star History
379 stars in the last 21 days

Explore Similar Projects

Feedback? Help us improve.