flight-finder
Retrieves cash fare information via Google Flights, enabling searches for one-way and round-trip flights across multiple origins and dates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@flight-finder find me SEA→Tokyo in business under 120k points"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
flight-finder
Find the genuinely best flight — cash or points — by ranking every option against what a mile is actually worth to you.
Three ways to use this
🧠 Build your own with Claude Code →
GUIDE.md🛠 Run the code → below
🚀 Just use it → hosted version (coming soon)
What it does
Award availability and cash fares live in a dozen places and change by the hour. flight-finder pulls both — cash fares (via Google Flights) and award space (via the seats.aero Pro API) — then ranks every option using your per-program cents-per-mile valuations and travel preferences. It also enriches each option with seat-quality detail from AeroLOPA — cabin layout, seat counts, and the actual seat map for the specific aircraft (tail-number matched) — so you're comparing the seat you'll actually sit in, not just the price. "Is this a good deal?" becomes a number, not a vibe. And it runs as an MCP server, so you can plan trips conversationally in Claude Code: "find me SEA→Tokyo in business under 120k points."
Related MCP server: PointsYeah MCP Server
Quickstart
uv sync
cp .env.example .env # add SEATS_AERO_API_KEY (+ optional AEROLOPA_API_ID / AEROLOPA_API_SECRET for seat maps)
# edit config/profile.yaml + config/programs.yaml (home airports, point balances, cpm values)
uv run ff search --from SEA --to FCO --depart 2026-11-21 --cabin BUSINESS
uv run ff awards --from SEA --to FCO --start 2026-11-18 --end 2026-11-23 --cabin business
uv run ff plan trips/example-trip.yaml --out trips/example-shortlist.mdMCP (Claude Code)
claude mcp add flight-finder --scope user \
-- uv --directory /path/to/flight-finder run python -m flight_finder.mcp_serverTools: search_cash_one_way, search_cash_round_trip, search_awards, find_positioning_flights, get_seat_map, plan_trip.
How it works
src/flight_finder/
offer.py # normalized Offer (cash or award) + Segment
config.py # profile + programs + env
cash/ # Google Flights wrapper + multi-origin × date fan-out
awards/ # seats.aero Pro client
strategy/scorer.py # cpm-based cost + preference-aware ranking ← the core idea
seatmaps/ # AeroLOPA enrichment: cabin product + seat map per aircraft (tail-matched)
planner.py # combines it all behind a TripSpec
cli.py · mcp_server.pyThe interesting decision: a single normalized Offer for cash and award, so the scorer can compare them on one axis — your dollar value — instead of apples-to-oranges price vs. miles.
What I learned building this
The hard part wasn't the model — it was the valuation layer. The same award seat is a steal or a trap depending on which points you hold, what you value, and even which seat you'll actually sit in. Encoding that judgment is what turns a search into a recommendation. It's true of most useful AI products: the model is the commodity; the context and the scoring are the moat.
Built with Claude Code
Built nights and weekends, mostly by talking to Claude — scaffolded, iterated, and tested through Claude Code.
License
MIT
Available Tools
6 toolsfind_positioning_flightsA
Find positioning flights from from_city to return_hub near return_date.
Useful for the asymmetric-return trick: main award returns from a hub (e.g.
LHR); family needs to get there from Italy. Candidates must be verified as
refundable on the airline site before booking.
Inputs: from_city (required), return_hub (required), return_date (required), earliest_days_before, +3 more.
get_seat_mapA
AeroLOPA cabin product + seat map URL for a specific aircraft.
Provide either `slug` (e.g. "ba-351") to skip resolution, or both
`carrier` (IATA, e.g. "BA") and `aircraft` (IATA code or displayed name).
Returns the structured CabinProduct dict — aircraft type, per-cabin pitch /
width / recline / amenities, free-text seat notes, and the
direct-CDN-cached seat map SVG URL. All cabins are included; pick the one
matching your offer cabin via `cabins[].cabin_type_name`.
Inputs: carrier, aircraft, slug.
plan_tripC
Run the full trip planner on a trips/*.yaml file.
Inputs: trip_yaml_path (required).
search_awardsD
Award search via seats.aero Pro API.
Inputs: origin_airports (required), destination_airports (required), start_date (required), end_date (required), +4 more. Returns: result
search_cash_one_wayC
Cash-fare one-way search via fli (Google Flights).
Inputs: origin (required), destination (required), depart_date (required), cabin, +6 more. Returns: result
search_cash_round_tripC
Cash-fare round-trip search via fli (Google Flights).
Inputs: origin (required), destination (required), depart_date (required), return_date (required), +5 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct aspect of flight finding: positioning flights, seat maps, trip planning, award search, and cash search (one-way and round trip). No overlaps.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., find_positioning_flights, get_seat_map, search_awards).
Six tools cover the core functionality of a flight finder without excess. The scope is well-scoped and manageable.
The set covers major flight search types (award, cash) and trip planning, but lacks tools for flight status, booking management, or filtering by amenities. Minor gaps exist.
Related MCP Connectors
Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.
Search award flights and cash fares, optimize points, and predict fares inside ChatGPT and Claude.
Personal AI travel agent. Points optimization, live flight/hotel/award search, trip planning.
Flight search, airfare analytics, flexible destinations
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceOfficial Industry Standard MCP for Travel Awards, Points, and more. Search award flight availability across multiple airline loyalty programs, find sweet spots, check transfer partners, and get market stats all via MCP.1-
- FlicenseNot gradedqualityCmaintenanceEnables award flight search across 20+ airline programs using PointsYeah, with tools for comparing programs, estimating points value, and checking redemption deals.-
- AlicenseNot gradedqualityDmaintenanceEnables tracking flights and grouping them into trips, with tools to create, list, and manage trips and flight bookings.ISC
- AlicenseAqualityBmaintenanceTravel award search: compare cash vs points on hotels, flights & cars, cents-per-point, and book319MIT