1. Conduid
  2. Developer Tools
  3. Flights MCP
MCP server · Developer Tools

Flights MCP

by · github.com/fastmcp-me/flights-mcp

An MCP server to search for flights.

Unclaimed GPL-3.0 last commit 9 months ago devtools
InstallView source
67Good

Scored 7 days ago · breakdown

About Flights MCP

Flights MCP is an MCP server published by fastmcp-me in the Developer Tools category: an MCP server to search for flights.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/fastmcp-me/flights-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

get_flight_option_detailsReturns detailed flight information including segments, pricing, baggage allowances, and agency terms.

Parameters not published.

get_flight_optionsRetrieves, filters, and sorts flight options from a previous search. Returns a paginated list of filtered flight options.

Parameters not published.

request_booking_linkGenerates a booking link for a specific flight option.

Parameters not published.

search_flightsSearches for flights using the Aviasales Flight Search API. Returns search description with `search_id` and summary of found options.

Parameters not published.

Ask AI

✦

Ask AI about Flights MCP

Powered by Claude · Grounded in docs

I know everything about Flights MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

3 checks have not been run yet.

README

Add to Cursor Add to VS Code Add to Claude Add to ChatGPT Add to Codex Add to Gemini

✈️ 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

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

  2. 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:

Tool Description
search_flights Searches for flights using the Aviasales Flight Search API. Returns search description with search_id and summary of found options.
get_flight_options Retrieves, filters, and sorts flight options from a previous search. Returns a paginated list of filtered flight options.
get_flight_option_details Returns detailed flight information including segments, pricing, baggage allowances, and agency terms.
request_booking_link Generates a booking link for a specific flight option.

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:

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Flights MCP

How do I install Flights MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Flights MCP safe to use with an AI agent?

Its trust score is 67 out of 100 (good). It passes 2 of the 3 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Flights MCP still maintained?

The last commit was 9 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.