pointpilot-core

Open-source award flight search engine. Find the best way to use credit card points for flights — with a REST API, MCP server for Claude Desktop, and a step-by-step booking playbook engine.

Live App · API Docs · MCP Setup

---

PointPilot searches across airline loyalty programs to find award flights, then tells you exactly how to book them:

1. Search — Enter your origin, dates, and points balances. PointPilot checks award availability across programs (Aeroplan, ANA, Virgin Atlantic, etc.) and compares against cash prices.
2. Rank — Results are scored by cents-per-point (CPP) value, cash savings, transfer path availability, and booking friction.
3. Playbook — Select a flight and get step-by-step transfer and booking instructions, including risk warnings (low seats, slow transfers, expiring promos).

| Program | Code | |---------|------| | Amex Membership Rewards | MR | | Chase Ultimate Rewards | CHASE | | Capital One Miles | CAP1 | | Citi ThankYou Points | CITI | | Bilt Rewards | BILT | | Marriott Bonvoy | MARRIOTT |

---

git clone https://github.com/wrahim3933/PointPilot.git
cd PointPilot/backend
pip install -r requirements.txt

cp .env.example .env
# Edit .env — no API keys needed for basic functionality (mock providers work out of the box)

uvicorn app.main:app --reload --port 8000

The API is now running at http://localhost:8000. Try it:

# Health check
curl http://localhost:8000/health

# Search for award flights from JFK in July
curl -X POST http://localhost:8000/v1/trip-searches \
  -H "Content-Type: application/json" \
  -d '{
    "origins": ["JFK"],
    "date_window_start": "2025-07-01",
    "date_window_end": "2025-07-15",
    "duration_nights": 5,
    "travelers": 2,