How to Use the Duffel MCP in Claude

Q: How do I handle seat selection for my flight?

Your agent runs getseatmaps to fetch the current cabin layout. You point to your preferred seat, and the agent updates the selection before finalizing the order.

Search live flights and book hotel stays directly inside your Claude Desktop chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Duffel MCP to Claude Desktop

Create your Vinkius account to connect Duffel to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Duffel with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run live flight searches in Claude Desktop

The Duffel MCP server equips your Claude Desktop client with tools to query real-time airline offers directly. Your agent calls `create_offer_request` to pull current pricing and schedules, then parses the results with `list_offers` to display options inside your chat. You don't need to open external tabs to check seat availability or verify carrier fees. The agent runs `get_seat_maps` and `price_offer` to confirm exact pricing details before you make any booking decisions.

Execute hotel bookings from your chat window

This MCP Server lets your agent search and book accommodations without leaving Claude Desktop. The agent executes `search_stays` and `fetch_stay_rates` to retrieve real-time room pricing and availability directly from lodging providers. When you find the right room, the agent runs `quote_stay` to lock in the rate. From there, it uses `book_stay` to complete the reservation and outputs the confirmation details in your chat window.

Manage active travel orders and payments

This integration handles post-booking operations directly through your desktop agent. If a traveler needs to modify a trip, the agent calls `change_order` or `cancel_order` to update the booking status instantly. For held bookings, the agent uses `create_payment` to settle the balance and runs `get_payment` to verify the transaction status. You get complete control over the booking lifecycle without touching a web portal.

Setup guide

Set up Duffel MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Duffel MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Duffel MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under duffel-mcp.

json

{
  "mcpServers": {
    "duffel-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Duffel. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Duffel now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Duffel MCP in Claude Desktop

You ask your agent to find flights between two cities on specific dates. Your agent uses the MCP Server to call `create_offer_request` and displays the matching options directly in your Claude Desktop chat.

Yes, you can complete the entire booking flow. Your agent runs `search_stays` to find rooms, gets a quote via `quote_stay`, and executes `book_stay` to secure the reservation.

You tell your agent to cancel the booking. The MCP tool initiates `cancel_order` using your unique order ID and returns the cancellation confirmation directly in the app.

Your agent runs `get_seat_maps` to fetch the current cabin layout. You point to your preferred seat, and the agent updates the selection before finalizing the order.

The server passes your passenger names and passport numbers directly to the Duffel API using secure HTTPS connections. Vinkius runs the process in an isolated, ephemeral V8 sandbox, meaning your private identity data is never stored on our servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript