MCP server for searching and retrieving flight information using Duffel API.

How it Works

Why This is Helpful

While tools like Google Flights work great for simple trips, this tool shines when dealing with complex travel plans. Here's why:

• Contextual Memory: Claude remembers all your previous flight searches in the chat, so you don't need to keep multiple tabs open to compare prices.
• Flexible Date Search: Easily search across multiple days to find the best prices without manually checking each date.
• Complex Itineraries: Perfect for multi-city trips, one-stop flights, or when you need to compare different route options you can just ask!
• Natural Conversation: Just describe what you're looking for - no more clicking through calendar interfaces or juggling search parameters down to parsing city names, dates, and times.

Think of it as having a travel agent in your chat who remembers everything you've discussed and can instantly search across dates and routes.

Features

• Search for flights between multiple destinations
• Support for one-way, round-trip, and multi-city flight queries
• Detailed flight offer information
• Flexible search parameters (departure times, cabin class, number of passengers)
• Automatic handling of flight connections
• Search for flights within multiple days to find the best flight for your trip (slower)

Available Tools

1. Search Flights

Supports three flight types:

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

Parameters include:

• type: Flight type ('one_way', 'round_trip', 'multi_city')
• origin: Origin airport code
• destination: Destination airport code
• departure_date: Departure date (YYYY-MM-DD)
• Optional parameters:
  • return_date: Return date for round-trips
  • 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

2. Get Offer Details

Retrieves comprehensive details for a specific flight offer using its unique ID.

3. Search Multi-City Flights

Specialized tool for complex multi-city flight itineraries.

Parameters include:

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

Use Cases

Some Example (But try it out yourself!)

You can use these tools to find flights with various complexities:

• "Find a one-way flight from SFO to NYC on Jan 7 for 2 adults in business class."
• "Search for a round-trip flight from LAX to London, departing Jan 8 and returning Jan 15."
• "Plan a multi-city trip from New York to Paris on Jan 7, then to Rome on Jan 10, and back to New York on Jan 15."
• "What is the cheapest flight from SFO to LAX from Jan 7 to Jan 15 for 2 adults in economy class?"
• You can even search for flights within multiple days to find the best flight for your trip. Right now, the recommendation is to only search for one-way or round-trip flights this way. Example: "Find the cheapest flight from SFO to LAX from Jan 7 to Jan 10 for 2 adults in economy class."

Response Format

The tools return JSON-formatted responses with:

• Flight offer details
• Pricing information
• Slice (route) details
• Carrier information
• Connection details

Error Handling

The service includes robust error handling for:

• API request failures
• Invalid airport codes
• Missing or invalid API keys
• Network timeouts
• Invalid search parameters

Performance Notes

• Searches are limited to 50 offers for one-way/round-trip flights
• Multi-city searches are limited to 10 offers
• Supplier timeout is set to 15-30 seconds depending on the search type

Cabin Classes

Available cabin classes:

• economy: Standard economy class
• premium_economy: Premium economy class
• business: Business class
• first: First class

Example request with cabin class: