Flyan MCP server

Flyan SDK

An open-source unofficial API wrapper to get flight data from Ryanair.

<!-- mcp-name: io.github.victorlane/flyan-mcp -->

[!TIP]

New: MCP server for AI agents. Plug Flyan into Claude Desktop,

Claude Code, or Cursor and search Ryanair flights in natural language.

Jump to the MCP Quickstart.

Contents

• Installation
• Quick Start
• API Reference
• Data Models
• Examples
• Explore Mode
• Use with Claude, Cursor, and other MCP clients
• Supported Airports
• Supported Currencies
• Rate Limiting
• Contributing
• Disclaimer

Installation

pip install Flyan

Or using uv:

uv add Flyan

Quick Start

from datetime import datetime
from flyan import RyanAir, FlightSearchParams

# Initialize the client
client = RyanAir(currency="EUR")

# Set up search parameters
search_params = FlightSearchParams(
    from_airport="DUB",  # Dublin
    to_airport="BCN",    # Barcelona
    from_date=datetime(2025, 8, 15),
    to_date=datetime(2025, 8, 20),
    max_price=200
)

# Search for one-way flights
flights = client.get_oneways(search_params)

# Display results
for flight in flights:
    print(f"Flight {flight.flight_number}: {flight.departure_airport.name} → {flight.arrival_airport.name}")
    print(f"Departure: {flight.departure_date}")
    print(f"Price: {flight.price} {flight.currency}")
    print("---")

API Reference

RyanAir Class

Constructor

RyanAir(currency: str = "EUR")

Creates a new RyanAir client instance.

Parameters:

• currency (str, optional): Preferred currency for pricing. Defaults to "EUR". Must be a valid currency code from the supported currencies list.

Example:

# Default EUR currency
client = RyanAir()

# Specific currency
client = RyanAir(currency="USD")

Methods

get_oneways(params: FlightSearchParams) -> list[Flight]

Search for one-way flights.

Parameters:

• params (FlightSearchParams): Search parameters

Returns:

• list[Flight]: List of available flights

FlightSearchParams Class

Parameters for searching flights.

FlightSearchParams(
    from_airport: str,
    from_date: datetime,
    to_date: datetime,
    destination_country: Optional[str] = None,
    max_price: Optional[int] = None,
    to_airport: Optional[str] = None,
    departure_time_from: Optional[str] = "00:00",
    departure_time_to: Optional[str] = "23:59"
)

Parameters:

• from_airport (str): IATA code of departure airport (e.g., "DUB")
• from_date (datetime): Earliest departure date
• to_date (datetime): Latest departure date
• destination_country (str, optional): Country code for destination
• max_price (int, optional): Maximum price filter
• to_airport (str, optional): IATA code of arrival airport
• departuretimefrom (str, optional): Earliest departure time (HH:MM format)
• departuretimeto (str, optional): Latest departure time (HH:MM format)

Example:

Shortened. The full README is on GitHub.