How to Use the Duffel MCP in Windsurf

Q: How does Windsurf use Duffel to find cheap flights?

Cascade triggers createofferrequest with your travel dates and destinations. It then uses listoffers to sort the results by price and displays the cheapest options directly in your editor.

Q: Can Windsurf book hotels automatically using Duffel?

Yes. Windsurf chains searchstays, fetchstayrates, and bookstay to find and reserve rooms without you writing boilerplate code.

Q: How do I handle seat selection inside Windsurf with Duffel?

Windsurf calls getseatmaps to pull the current cabin layout for a specific flight offer. Cascade displays the available seats so you can pick your spot before booking.

Q: What happens if I need to cancel a flight order?

You ask Windsurf to cancel, and it runs cancelorder using the order ID. It retrieves the cancellation confirmation status instantly.

Let Cascade autonomously search, book, and manage flights and hotel stays directly in Windsurf using the Duffel MCP Server.

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 Windsurf

Create your Vinkius account to connect Duffel to Windsurf 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous flight searches inside Windsurf

The `create_offer_request` tool lets Cascade find flights across dozens of airlines directly inside Windsurf. Cascade chains this search with `list_offers` to pull real-time Duffel pricing without requiring manual prompts. As Cascade parses the raw Duffel flight options, it presents the best routes directly in your Windsurf editor. It then runs `get_seat_maps` to show you open seats before you make any booking decisions in Windsurf.

Multi-step hotel bookings with Cascade

The `search_stays` tool lets Windsurf find accommodations based on your specific travel criteria. Windsurf takes these Duffel results, runs `fetch_stay_rates` to check pricing, and triggers `quote_stay` to lock in the rate. Because Windsurf chains Duffel travel commands, it executes the entire hotel sourcing flow in one pass. Windsurf presents you with the finalized Duffel quote and awaits your nod to execute the booking.

Instant order creation and payment holds

The `create_order` tool lets Windsurf book the selected flight or stay instantly. When a booking requires a hold, Windsurf uses `create_payment` to process the Duffel payment and secure the reservation. If plans change, Windsurf calls `change_order` or `cancel_order` to update the reservation. You manage the entire ticketing lifecycle directly from your Windsurf chat using this Duffel MCP Server.

Setup guide

Set up Duffel MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Duffel MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Duffel payment history." If connected, Cascade will call the Duffel tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Cascade triggers `create_offer_request` with your travel dates and destinations. It then uses `list_offers` to sort the results by price and displays the cheapest options directly in your editor.

Yes. Windsurf chains `search_stays`, `fetch_stay_rates`, and `book_stay` to find and reserve rooms without you writing boilerplate code.

Windsurf calls `get_seat_maps` to pull the current cabin layout for a specific flight offer. Cascade displays the available seats so you can pick your spot before booking.

You ask Windsurf to cancel, and it runs `cancel_order` using the order ID. It retrieves the cancellation confirmation status instantly.

The Duffel integration runs inside a secure Vinkius sandbox. Your traveler names, passport numbers, and payment tokens processed via `create_payment` never touch external logs.

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