Flight Ticket

Flight Ticket MCP Server provides a structured, programmable interface for AI assistants to perform real-time airline flight queries. It exposes tools for routes, transfers, weather, flight details, and live tracking, all through the MCP protocol to enable seamless, standardized interactions with flight data sources.

How to use

You connect your MCP client to the Flight Ticket MCP Server to access a set of flight-related tools. Start the server using the recommended local runtime, then configure your MCP client to call the available tools. You can perform practical tasks such as finding available flights between cities on a given date, checking transfer options, retrieving current weather for a city or coordinates, and tracking flight statuses in real time.

How to install

Prerequisites: You need Python 3.11 or higher and a Python package manager (pip). You may also use uv to run packages directly without a full install.

Option 1: Install via uvx (recommended) and run the MCP server without installing Python packages globally.

{
  "mcpServers": {
    "flight-ticket-server": {
      "command": "uvx",
      "args": ["flight-ticket-mcp-server@latest"]
    }
  }
}

Additional configuration and startup notes

If you prefer to run without uvx, you can install the package and start the server directly. The typical flow is to install the package and then start the server with the appropriate entry point.

Direct start using Python after installation: you may run the server entry file directly, for example with the main Python startup file or the dedicated server script.

Option 2: Install via pip and run after installation.

pip install flight-ticket-mcp-server

Then start the server using the provided startup command, for example:

python flight_ticket_server.py

Configuration and environment

You can customize transport, host, port, and logging through environment variables or an .env file. This server supports multiple transport protocols (SSE, stdio, and streamable-http) and provides debugging, logging, and performance controls.

Key environment variables include transport type, host, port, and path for the MCP API, plus logging controls and a debugging flag.

Troubleshooting and tips

If you encounter issues starting the server, verify that the chosen runtime command is available and that the environment variables are set correctly. Check logs under the logs/ directory for startup messages and errors.

Common issues include port conflicts, invalid configuration syntax, and missing dependencies. Use the provided log files to identify the exact failure point and adjust your setup accordingly.

Available tools

searchFlightRoutes

Query available flight routes based on departure city, destination, and date. Returns flights, prices, airline, timings, and airport details.

getCurrentDate

Return the current system date in YYYY-MM-DD format.

getTransferFlightsByThreePlace

Find transfer itineraries across three places with optional min and max transfer times and full segment details.

getWeatherByLocation

Get weather information for a latitude/longitude range, with optional date range.

getWeatherByCity

Get weather information for a city or region with optional date range.

getFlightInfo

Query detailed information for a specific flight by flight number.

getFlightStatus

Retrieve real-time status for a specific flight.

getAirportFlights

Query flights around a specific airport within a 30 km radius.

getFlightsInArea

Query real-time flights within a defined geographical area.

trackMultipleFlights

Track multiple flights simultaneously and summarize their real-time status.