What is Flights Mcp

Flights-MCP is a Model Context Protocol (MCP) server that enables users to search for flights using the Aviasales Flight Search API, offering granular filtering, sorting options, and booking integration.

Use cases

Use cases include searching for flights for personal travel, integrating flight search into travel booking platforms, providing flight information to users in travel apps, and assisting travel agents in finding suitable flights for clients.

How to use

Users can utilize the remote MCP server available at https://findflights.me/sse without setup, or they can deploy their own instance by following the installation instructions and obtaining an Aviasales API Key.

Key features

Key features include flight search for one-way, round-trip, and multi-city flights, advanced filtering by various criteria, multiple sorting options, detailed flight information, booking links generation, local storage of searches, and support for multiple MCP transport options.

Where to use

Flights-MCP can be used in travel agencies, flight comparison websites, travel planning applications, and any platform that requires flight search capabilities.

✈️ Flights MCP Server

A Model Context Protocol (MCP) server that provides flight search capabilities using the Aviasales Flight Search API. This server allows you to search for flights, filter results, get detailed flight information, and generate booking links.

https://github.com/user-attachments/assets/87d79d54-c4ab-4938-9792-18572315f1ba

How to use

You can either use the remote MCP server or deploy your own instance:

• Remote MCP
  A public instance is available at:
  https://findflights.me/sse
  This server uses the SSE transport protocol and is ready to use without setup.

  ⚠️ Important: Currently not all LLM clients support remote MCP connections. For example, Claude.ai supports remote MCP integrations only on Pro+ plans.

• Self-Hosted Deployment
  If you prefer to run your own server, follow the instructions in the Installation section.

  Note: To deploy your own server, you must obtain an Aviasales API Key and Marker ID.

Features

• Flight Search: Search for one-way, round-trip, and multi-city flights
• Advanced Filtering: Filter results by price, duration, airlines, departure/arrival times, and number of stops
• Multiple Sorting Options: Sort by price, departure time, arrival time, or duration
• Detailed Flight Information: Get comprehensive flight details including baggage allowances and airline information
• Booking Links: Generate booking links for selected flights
• Local Storage: Performed searches are stored locally so LLM can access past searches without waiting
• Multiple MCP Transport Options: Supports stdio, HTTP, and SSE transports

Installation

Prerequisites

• Aviasales API key
• Python 3.12 or higher
• UV package manager

Setup

1. Clone the repository:

git clone <repository-url>
cd flights-mcp

3. Set up environment variables (see Environment Variables section)

4. Run the server

uv run src/flights-mcp/main.py

The server binds to 0.0.0.0, making it accessible on all network interfaces of the host machine.

Environment Variables

The following environment variables are required:

• FLIGHTS_AVIASALES_API_TOKEN (required): Your Aviasales API token

• FLIGHTS_AVIASALES_MARKER (required): Your Aviasales marker ID

• FLIGHTS_TRANSPORT (optional): Transport protocol to use

  • Options: stdio (default), streamable_http, sse

• FLIGHTS_HTTP_PORT (optional): Port for HTTP/SSE transport

  • Only used when FLIGHTS_TRANSPORT is streamable_http or sse
  • Default: 4200

• FLIGHTS_HTTP_PATH (optional): URI path for the endpoint

  • Only used when FLIGHTS_TRANSPORT is streamable_http or sse
  • Default: /mcp

MCP Tools

The server provides the following MCP tools:

Typical Usage Pattern

1. Search for flights using search_flights() - Call multiple times for flexible dates
2. Filter and browse options using get_flight_options() - Lightweight tool, call multiple times with different filters and sorting option
3. Get detailed information using get_flight_option_details() - For user’s preferred options
4. Generate booking link using request_booking_link() - Only when user confirms booking intent

Support

For issues related to:

• MCP Server: Open an issue in this repository
• MCP Protocol: See Model Context Protocol Documentation