Flywizz MCP server

Flywizz SDK

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

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

[!TIP]

MCP server for AI agents included. Plug Flywizz into Claude Desktop,

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

Jump to the MCP Quickstart.

Contents

• Installation
• Quick Start
• Three things to know first
• API Reference
• Data Models
• Examples
• Checking many routes at once
• Flights that need a connection
• Explore Mode
• Use with Claude, Cursor, and other MCP clients
• API characteristics
• Caching

Installation

pip install Flywizz

Or using uv:

uv add Flywizz

Quick Start

from datetime import datetime, timedelta
from flywizz import WizzAir, TimetableSearch

# Initialize the client
client = WizzAir()

# Set up search parameters
search = TimetableSearch(
    origin="BUD",       # Budapest
    destination="LTN",  # London Luton
    date_from=datetime.now() + timedelta(days=30),
    date_to=datetime.now() + timedelta(days=60),
)

# One call gets the schedule and the prices
for day in client.get_timetable(search):
    if day.price is None:
        continue
    print(f"{day.departure_date.date()}: {day.price.amount} {day.price.currency}")
    print(f"  departures: {', '.join(d.departure.strftime('%H:%M') for d in day.departures)}")

Each entry is one operating day: the cheapest fare that day, plus every departure time, so a single call answers both "when does it fly" and "what does it cost".

Three things to know first

Prices are in the departure station's currency

Wizz Air has no server-side currency override. BUD -> LTN quotes in HUF, LTN -> BUD quotes in GBP, WAW -> LTN in PLN. Body fields, query params, cookies and headers named currency are all ignored.

Read Station.currencycode from getnetwork() if you need to know which currency you'll get before you search, and convert client-side.

Not every operating day carries a price

timetableV2 and farechart attach a price object to every day, but on days they will not quote inline, the amount is 0 and pricetype is either checkPrice (a fare exists, but only through search/search) or noData. Flywizz maps both to price=None, so an unpriced day is never mistaken for a free one. Timetable entries still expose the indicative fare through originalprice:

for day in client.get_timetable(search):
    if day.price is not None:
        print(day.departure_date.date(), day.price.amount, day.price.currency)
    elif day.original_price is not None:
        print(day.departure_date.date(), "~", day.original_price.amount, "(check price)")

Search windows are capped, and the caps differ

Shortened. The full README is on GitHub.