Flight Simulator

You have a Python-based MCP server that powers comprehensive airline booking operations. It provides core booking tools, real-time flight information, loyalty features, and AI-powered prompts to help you search, book, check-in, track flights, and optimize loyalty benefits all from a single, extensible MCP endpoint.

How to use

Connect your MCP client to the flight simulator MCP server to perform practical operations like searching for flights, creating bookings, checking in, and tracking live flight status. You can also manage groups, apply loyalty accounts, and handle disruptions with AI-powered prompts to guide you through complex workflows. Use the same server for both standard bookings and real-time operations, ensuring you have proper authentication and environment setup before making requests.

How to install

Prerequisites include Python 3.10 or higher and a package manager. The recommended workflow uses UV to manage Python dependencies, but you may also use pip directly.

# Prerequisites
python3 --version
uv --version

# Step 1: Clone the flight simulator MCP server
git clone <repository-url>
cd flight-sim-mcp

# Step 2: Install dependencies (UV recommended) 
uv pip install -r requirements.txt

# Or with pip directly
pip install -r requirements.txt

# Step 3: Copy environment configuration and edit
cp .env.example .env
# Edit the .env file with appropriate values using your preferred editor

# Step 4: Run the server (stdio/standard I/O mode by default)
python src/server.py

Additional notes

For local development and testing, you can run the MCP server in stdio mode, which is suitable for integration with clients like Claude Desktop. The server entry point is python src/server.py.

Available tools

search_flights

Search flights using multiple criteria such as origin, destination, dates, and passenger details.

get_flight_details

Retrieve detailed information about a specific flight, including seats and policies.

create_booking

Create a new flight booking with selected flights and passenger data.

get_booking

Retrieve details for an existing booking by its reference.

cancel_booking

Cancel a booking and compute any applicable refund.

modify_booking

Change flights, dates, or passenger details for an existing booking.

check_in

Perform online check-in and generate boarding passes.

select_seats

Choose specific seats for passengers.

add_baggage

Add or modify checked baggage to a booking.

add_services

Add services like meals, Wi-Fi, or priority boarding to a booking.

travel_insurance

Offer and apply trip protection options.

special_assistance

Request accessibility or special assistance services.

track_flight

Provide real-time flight status updates.

price_alert

Set up alerts for price changes on selected routes.

loyalty_account

Link and manage frequent flyer accounts.

group_booking

Handle bookings for 5+ passengers in a single group.

upgrade_seat

Request or manage seat upgrades when available.