Flights MCP Server

Name: Flights MCP Server
Author: maratsarbasov

@maratsarbasov

Repository

About Flights MCP Server

MCP server searching flights with granular filtering, sorting options, and purchase integration.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "flights-mcp-maratsarbasov": {
      "command": "uv",
      "args": [
        "run",
        "src/flights-mcp/main.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Flights MCP Server?

Flights MCP Server is a Model Context Protocol (MCP) server that provides flight search capabilities via the Aviasales Flight Search API. It allows LLM-based tools to search for flights, filter results, retrieve detailed flight information, and generate booking links. It is designed for developers integrating flight search into AI assistants or other applications.

How to use Flights MCP Server?

You can use the public remote instance at https://findflights.me/sse (SSE transport) or deploy your own instance by obtaining an Aviasales API token and marker ID. For self-hosting, set environment variables (FLIGHTS_AVIASALES_API_TOKEN, FLIGHTS_AVIASALES_MARKER, optionally FLIGHTS_TRANSPORT, FLIGHTS_HTTP_PORT, FLIGHTS_HTTP_PATH) and run the server with uv run src/flights-mcp/main.py. The server supports stdio, streamable HTTP, and SSE transports.

Key features of Flights MCP Server

Flight search for one-way, round-trip, and multi-city trips
Advanced filtering by price, duration, airlines, times, and stops
Multiple sorting options: price, departure time, arrival time, duration
Detailed flight information including baggage allowances and airline info
Booking link generation for selected flight options
Local storage of past searches for quick re-access

Use cases of Flights MCP Server

Find the cheapest flights between two cities for flexible dates
Filter flight results by preferred airline and number of stops
Get comprehensive details about a specific flight option before booking
Generate a booking link once the user confirms intent to book
Compare multiple searches (e.g., different departure airports) within a single session

FAQ from Flights MCP Server

Is there a public instance I can use without setup?

Yes, a remote MCP server is available at https://findflights.me/sse. It uses SSE transport and works out of the box, but not all LLM clients support remote MCP connections (e.g., Claude.ai requires a Pro+ plan).

What are the prerequisites for self-hosting?

You need an Aviasales API token and marker ID, Python 3.12 or higher, and the UV package manager.

Which transport protocols does the server support?

The server supports stdio (default), streamable HTTP, and SSE transports. Set the FLIGHTS_TRANSPORT environment variable to choose.

How do I configure environment variables?

Set FLIGHTS_AVIASALES_API_TOKEN (required), FLIGHTS_AVIASALES_MARKER (required), and optionally FLIGHTS_TRANSPORT, FLIGHTS_HTTP_PORT, and FLIGHTS_HTTP_PATH. Port defaults to 4200 and path to /mcp.

Are there any known limits or authentication requirements?

The remote instance is publicly accessible but requires client support for remote MCP. Self-hosted instances require a valid Aviasales API key. No other limits are mentioned in the README.