CHEAP_FLIGHTS_MCP

MCP server for searching cheap flights in real-time via RyanAir, WizzAir, and Google Flights.

Built with FastMCP (Anthropic's Model Context Protocol), featuring parallel airline queries via asyncio.gather, exponential backoff retry, and verified booking deep links.

Features

Real-time prices directly from airline systems (not cached/aggregated)
Parallel search across multiple airlines simultaneously
FastMCP - modern declarative MCP pattern (2025 standard)
Web UI - browser-based interface with dark theme
AI Agent - conversational flight search via Claude (SAP Hyperspace)
Deep booking links - click to buy directly on airline website
Email results - send search results via email (mailto: protocol)
Configurable airlines - add/remove airlines dynamically
USD/EUR conversion - live exchange rate for Google Flights results
Retry mechanism - exponential backoff + jitter for rate-limited APIs
Security - input validation, generic errors, no credentials in code

Supported Airlines

| Airline | Data Source | Destinations | Reliability | |---------|-------------|-------------|-------------| | RyanAir | ryanair-py library | Routes API (all, incl. seasonal) | Excellent | | WizzAir | Unofficial JSON API | Route map | Good (429 retry) | | Google Flights | fast-flights library | N/A | Good (verification source) |

Installation

git clone https://github.com/IngRobertFodor/CHEAP_FLIGHTS_MCP.git
cd CHEAP_FLIGHTS_MCP
pip install -r requirements.txt

Quick Start

Option A: Web UI (no AI required)

python web/app.py

Open browser: http://localhost:5000

Option B: CLI AI Agent (requires AI Proxy)

python agent/flight_agent.py

Option C: MCP Server only (for integration)

python mcp_server/server.py

Configuration

Create a .env file:

AI_PROXY_BASE_URL=http://localhost:6655
AI_PROXY_API_KEY=your-api-key-here

Note: The .env file is gitignored and never committed. Each user provides their own API key.

Edit mcp_server/config.json to configure active airlines:

{
    "active_airlines": ["ryanair", "wizzair"],
    "available_airlines": ["ryanair", "wizzair", "google_flights"]
}

MCP Tools

| Tool | Description | |------|-------------| | search_flights | Search flights between airports (origin, destination, date, return_date, adults) | | list_active_airlines | Show currently active airlines | | add_airline | Add an airline to active list | | remove_airline | Remove an airline from active list | | get_destinations | Get all available routes from an airport |

Usage Example

Web UI

Enter IATA codes (BTS, STN, BCN...)
Select dates and passengers
Click "Search flights"
Optionally: check "Send email" to email results with booking links

AI Agent

You: Find the cheapest flight from Bratislava to London on July 15, 2026
Agent: [calls search_flights] Found RyanAir BTS->STN for 19.99 EUR...

Architecture

Browser → Flask (app.py) → MCP Server (server.py) → RyanAir/WizzAir API
                                                  → Google Flights
                        → Claude AI (optional, via SAP Hyperspace)

The web form searches without AI - directly calling MCP tools. The AI chat requires Claude (via SAP AI Proxy).

Testing

# Quick test (no AI needed):
python test_search.py

# Full agent test (8 use cases, requires AI Proxy):
python test_agent_prompts.py

Adding a New Airline

Create mcp_server/airlines/new_airline.py (inherit from BaseAirline)
Implement search_flights() and get_destinations()
Add import to mcp_server/airlines/__init__.py
Add to config.json → available_airlines
Add to server.py → get_airline_adapters()

Security

API keys stored in .env (gitignored, never committed)
Flask runs with debug=False
CORS restricted to localhost
Input validation and sanitization (IATA codes, dates, adults)
Generic error messages (no internal info leaked)
All logging to stderr (stdout reserved for MCP communication)

Tech Stack

Python 3.12+
MCP SDK 1.27+ (FastMCP)
httpx (async HTTP)
tenacity (retry with backoff)
ryanair-py (RyanAir API)
fast-flights (Google Flights)
Flask + flask-cors (Web server)
SAP Hyperspace AI Proxy (Claude)

License

MIT License - see LICENSE

Author

Robert Fodor - 2026

MCP Servers