# 🛫 CheapFlights MCP

An open-source MCP server that helps you find the **cheapest flights** with smart suggestions.

## Features

- 🔍 **Search flights** — Find cheapest options for any route
- 📅 **Flexible dates** — See which dates are cheapest across a month
- 💡 **Smart suggestions** — Nearby airports, date shifts, savings tips
- 👨‍👩‍👧‍👦 **Family pricing** — Calculates total for adults + children
- ⚡ **Fast** — Direct Google Flights API access (no scraping)

## Install

```bash
# Install dependencies
pipx install flights  # provides fli-mcp and fli CLI

# Install this MCP server
pip install cheapflights-mcp
```

## Usage with Claude / Kiro / AI Assistants

Add to your MCP config:

```json
{
  "mcpServers": {
    "cheapflights": {
      "command": "cheapflights-mcp"
    }
  }
}
```

Then ask your AI:
- "Find cheapest flights from Melbourne to Tokyo in October for 2 adults and 2 kids"
- "What are the cheapest dates to fly Sydney to London in January?"
- "Suggest cheaper alternatives for JFK to NRT on Dec 25"

## MCP Tools

| Tool | Description |
|------|-------------|
| `search_flights` | Compare flight prices, sorted by cheapest |
| `find_cheapest_dates` | Price calendar across a date range |
| `suggest_alternatives` | Nearby dates, airports, and route alternatives |

## Development

```bash
git clone https://github.com/YOUR_USERNAME/cheapflights-mcp.git
cd cheapflights-mcp
pip install -e .
cheapflights-mcp  # runs on stdio
```

## Roadmap

- [ ] Multi-source: Add Skyscanner, Kiwi.com APIs
- [ ] Price alerts: Notify when prices drop
- [ ] Destination discovery: "Where can I fly for $500?"
- [ ] Price history: "Is this a good deal?"
- [ ] Booking links: Direct links to book

## License

MIT