Flight Planner

The Flight Planner MCP Server lets you search for flights, generate comprehensive travel plans, and look up airport codes by interacting with a Model Context Protocol (MCP) client. It provides fast, travel-focused capabilities that you can combine into practical workflows, such as finding one-way or round-trip options and building detailed itineraries for trips.

How to use

You connect to this MCP server from an MCP client and call its available tools to search flights, assemble travel plans, or retrieve airport codes. Practical workflows include: finding one-way or round-trip flights between airports, generating a complete travel plan based on your dates and destinations, and looking up airport codes for places you plan to visit. You can also use templates to quickly run common travel queries.

How to install

Prerequisites: ensure you have Python 3.10 or higher installed on your system.

Install the required packages using Python’s package manager.

pip install mcp fast-flights

Run the Flight Planner MCP Server directly with Python.

python flight_planner_server.py

Integrate with Claude Desktop by adding an MCP server configuration. Create or edit your Claude Desktop configuration file, then add the flight-planner server entry.

{
  "mcpServers": {
    "flight-planner": {
      "command": "python",
      "args": [
        "/PATH/TO/flight_planner_server.py"
      ],
      "env": {
        "PYTHONPATH": "/PATH/TO/PROJECT"
      }
    }
  }
}

Using the MCP Inspector

For testing and development, you can use the MCP Inspector to interact with your server from the command line.

# Install the inspector
npm install -g @modelcontextprotocol/inspector

# Run the inspector with your server
npx @modelcontextprotocol/inspector python flight_planner_server.py

What you can do with this server

Available tools let you search flights and build travel plans.

• search_one_way_flights: Find one-way flights between two airports
• search_round_trip_flights: Find round-trip options between airports
• create_travel_plan: Generate a comprehensive travel plan based on your trip parameters

Resources and prompts

Access templates and endpoints to facilitate your queries.

Notes on usage and capabilities

You can query airport codes, search for flights, and generate full itineraries. Use templates to streamline common travel questions and customize parameters to fit your trip.

Troubleshooting and tips

If you run into issues starting the server, verify that Python 3.10+ is installed, the required packages are installed, and the path to flight_planner_server.py is correct. Ensure the PYTHONPATH environment variable is set when integrating with Claude Desktop.

Available tools

search_one_way_flights

Searches for one-way flight options between two airports, returning available itineraries and prices if provided by the fast-flights API.

search_round_trip_flights

Searches for round-trip flight options between two airports, returning options for outbound and return segments with possible dates and prices.

create_travel_plan

Generates a comprehensive travel plan based on trip parameters such as origin, destination, dates, and preferences, consolidating flight options, layovers, and timings into a single itinerary.