Find Flights (Duffel)

🚀 Find the Right Flight

This project provides tools to search for flights with various parameters and handle different flight types.

🚀 Quick Start

✨ Features

• Support for three types of flights: one - way, round - trip, and multi - city flights.
• Robust error handling for common issues.
• JSON - formatted responses with detailed flight information.

📦 Installation

No installation steps are provided in the original README, so this section is skipped.

💻 Usage Examples

Basic Usage

# Search for flights
@mcp_tool()
async def search_flights(params: FlightSearch) -> str:
    """Search for flights based on the given parameters."""

This function supports three types of flights:

• One - way flights
• Round - trip flights
• Multi - city flights

The parameters include:

• type: Flight type ('one_way', 'round_trip', 'multi_city')
• origin: Departure airport code
• destination: Destination airport code
• departure_date: Departure date (YYYY - MM - DD)
• Optional parameters:
  • return_date: Return date (for round - trip flights)
  • adults: Number of adult passengers
  • cabin_class: Preferred cabin class
  • departure_time: Specific departure time range
  • arrival_time: Specific arrival time range
  • max_connections: Maximum number of connections

# Get flight offer details
@mcp_tool()
async def get_offer_details(params: OfferDetails) -> str:
    """Get detailed information about a specific flight offer."""

Use a unique ID to get comprehensive details of a specific flight offer.

# Search for multi - city flights
@mcp_tool(name="search_multi_city")
async def search_multi_city(params: MultiCityRequest) -> str:
    """Search for multi - city flights."""

This is a tool specifically designed for complex multi - city flight itineraries.

The parameters include:

• segments: List of flight segments
• adults: Number of adult passengers
• cabin_class: Preferred cabin class
• max_connections: Maximum number of connections

Advanced Usage

You can use these tools to search for flights of various complexities:

• "Find a one - way flight from SFO to New York on January 7, 2025, for 2 adults in business class."
• "Find a round - trip flight between Los Angeles and London, departing on January 8, 2025, and returning on January 15, 2025."
• "Plan a multi - city trip from New York to Paris on January 7, 2025, then to Rome on January 10, 2025, and finally back to New York on January 15, 2025."
• "What is the cheapest flight from SFO to LAX for 2 adults in economy class between January 7, 2025, and January 15, 2025?"
• You can even search for flights that go back and forth over multiple days. Currently, it is recommended for one - way or round - trip flights. For example: "Find the cheapest flight from SFO to LAX for 2 adults in economy class between January 7, 2025, and January 10, 2025."

📚 Documentation

Response Format

The tools return JSON - formatted responses, including:

• Flight offer details
• Price information
• Route details
• Carrier information
• Connection details

Error Handling

The service includes robust error - handling capabilities, including:

• Failed API requests
• Invalid airport codes
• Missing or invalid API keys
• Network timeouts
• Invalid search parameters

Performance Considerations

• Each flight search returns a maximum of 10 results.
• Complex multi - city itineraries may require longer processing times.

By following these guidelines, you can effectively use the provided tools to find and manage flights.