# Duffel MCP for AI Agents AI Agent Connect

> Duffel MCP connects your travel booking account to your AI agent. It lets you search for flights, book hotels, and manage orders in real time without leaving your chat interface. It handles live pricing, seat maps, and order updates for a smoother travel management experience.

## Overview
- **Category:** payment-processing
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DXbnZgdFixvv7n6I8hmHhoxrzI0JPZIn6jFhQB1n/ai-agent-connect
- **Tags:** flight-booking, hotel-search, travel-api, itinerary-management, airline-data

## Description

Duffel MCP connects your travel booking account to your AI agent. It turns your chat into a professional travel desk where you can find flights, book stays, and manage itineraries in real time. Instead of toggling between different booking portals and tabs, you can ask your agent to find the best options for a specific route or destination. It pulls live data on flight prices, hotel rates, and even seat maps. You can also handle the back-end tasks like updating an existing order, processing payments for held seats, or looking up specific airport and airline information. It works by pulling from the Duffel API to give you a professional travel experience directly in your workspace. You'll find it's a huge upgrade for anyone who spends their day managing complex travel itineraries. You can even set up webhooks to keep your records updated automatically. It's a solid way to get travel booking power into any MCP-compatible client through the Vinkius catalog.

## Tools

### create_offer_request
Create a flight offer request. This starts the process of finding available flights for a trip.

### create_order
Create a flight order. This is how you finalize a flight booking in the system.

### create_payment
Create a payment for a hold order. Use this to secure a seat before finalizing the booking.

### create_webhook
Create a webhook for updates. This lets you get notified about order changes automatically.

### fetch_stay_rates
Fetch all rates for a stay search result. Use this to see current pricing for hotels.

### get_accommodation
Get specific accommodation details. This provides deep info on a hotel or stay.

### get_aircraft
Get a specific aircraft type. Use this to see plane info for your travelers.

### get_airline
Get a specific airline. Use this to pull info about various carriers.

### get_airport
Get a specific airport. This helps you find location and terminal info.

### get_offer_request
Get a specific offer request. Use this to view the details of a search request.

### get_offer
Get a specific flight offer. This pulls the details for one specific flight option.

### list_accommodation
List accommodations. Use this to browse hotels in a specific area.

### list_aircraft
List aircraft types. This provides a directory of planes in the system.

### list_airlines
List airlines. Use this to see every carrier available in the database.

### list_airports
List airports. This gives you a full directory of airport locations.

### list_offer_requests
List offer requests. Use this to see your current search history.

### list_offers
List offers. This shows all options for a specific search request.

### list_orders
List orders. Use this to see every booking in your account.

### list_webhook_events
List webhook events. Use this to check the history of automated updates.

### price_offer
Verify final price and services for an offer. Use this to confirm costs before booking.

### suggest_accommodation
Suggest accommodations by name. Use this to find specific hotels quickly.

### search_stays
Search for stays. Use this to find hotels and other accommodations in a specific city.

### change_order
Request a change to an existing order. Use this to modify dates or passenger details on a flight.

### get_order
Get a specific flight order. Use this to check the status of a booking.

### get_payment
Get a specific payment. Use this to check payment status.

### quote_stay
Create a quote for a stay. Use this to provide a price estimate to a client.

### get_seat_maps
Get seat maps for an offer. Use this to show your clients where they can sit.

### book_stay
Book a stay. Use this to finalize a hotel or accommodation booking.

### cancel_order
Cancel an order. Use this to void an existing flight booking.

## Prompt Examples

**Prompt:** 
```
Search for one-way flights from JFK to LHR on October 12th for 1 adult in economy.
```

**Response:** 
```
I've searched for flights from JFK to London Heathrow on October 12th. Here are the best options I found:

| Airline | Departure | Price |
| :--- | :--- | :--- |
| British Airways | 10:00 AM | $540 |
| Virgin Atlantic | 11:30 AM | $565 |

Would you like me to get the seat maps for one of these or proceed with a booking?
```

**Prompt:** 
```
List my recent flight orders and show me the status of the last one.
```

**Response:** 
```
I've retrieved your recent flight orders. You have 3 active bookings:

* **Order ord_9921** (Paris) - Confirmed
* **Order ord_8832** (New York) - Confirmed
* **Order ord_7741** (Tokyo) - Pending

The latest order for your trip to Paris is currently **confirmed**.
```

**Prompt:** 
```
Find hotels in Tokyo for check-in on Nov 1st and check-out on Nov 5th for 2 adults.
```

**Response:** 
```
I've found several highly-rated stays in Tokyo for those dates:

* **Park Hyatt Tokyo**
* **Shinjuku Prince Hotel**

Would you like me to fetch the specific nightly rates for one of these, or should I look for other options?
```

## Capabilities

### Book flights and hotels
Find available travel options and finalize bookings through natural conversation.

### Manage flight orders
Update, retrieve, or cancel existing bookings directly from your agent.

### Fetch live travel data
Get real-time pricing, airport info, and airline details instantly.

### View seat maps
See specific seat configurations for flight offers before booking.

### Handle payments
Process payments for held orders to secure your travel plans.

## Use Cases

### Quickly finding a flight for a VIP
A travel agent asks their agent to find a non-stop flight from JFK to LHR for a specific date. The agent pulls the best offers and shows the seat maps immediately.

### Handling a corporate cancellation
A travel manager tells their agent to cancel a flight for an employee who can no longer travel. The agent processes the cancellation and confirms the status.

### Providing a hotel quote for a client
A concierge asks the agent to find hotels in Tokyo and provide a price quote for a three night stay. The agent fetches the rates and presents them in a table.

### Building a custom travel dashboard
A developer uses the Connector to feed real-time flight and stay data into a custom internal tool for their company's sales team.

## Benefits

- Stop manual searching by letting your agent find flights and hotels in real time.
- Handle updates instantly by modifying or canceling existing bookings with one command.
- Get accurate pricing by fetching live rates and confirming final costs before you pay.
- Manage complex data by pulling airport, airline, and aircraft details into your chat.
- Simplify payments by processing holds and viewing payment statuses directly in your workspace.
- Improve customer service by showing your clients exact seat maps before they book.

## How It Works

The bottom line is you get a professional travel booking engine inside your favorite AI client.

1. Subscribe to the Duffel MCP in the Vinkius catalog.
2. Enter your Duffel Access Token in your client configuration.
3. Ask your agent to find flights, search for hotels, or manage your bookings.

## Frequently Asked Questions

**Can I book flights with Duffel MCP?**
Yes, you can search for flights and finalize bookings directly through your AI agent. It handles the offer requests and order creation for you.

**Can I find hotels using Duffel MCP?**
Absolutely. You can search for accommodations, fetch real-time stay rates, and even get quotes for specific hotels.

**Does Duffel MCP show seat maps?**
Yes, it can retrieve seat maps for specific flight offers so you can see exactly where passengers can sit before booking.

**Can I cancel a flight with Duffel MCP?**
Yes, you can request a cancellation for an existing flight order directly through the chat interface.

**Can I get airport information with Duffel MCP?**
Yes, the Connector can pull specific details for airports, including location and other relevant metadata.

**Can I create quotes for stays with Duffel MCP?**
Yes, you can generate price quotes for accommodations to share with clients before making a final booking.

**How do I search for flights between two cities?**
Use the `create_offer_request` tool. You'll need to provide the origin, destination, departure date, and passenger details. The agent will then return available flight offers.

**Can I see the seat map before booking a flight?**
Yes! Once you have an Offer ID, use the `get_seat_maps` tool to retrieve the visual layout and availability of seats for that specific flight offer.

**How do I find hotel rates for a specific search result?**
After performing a search with `search_stays`, use the `fetch_stay_rates` tool with the `search_result_id` to get all available pricing and room options for that accommodation.