How to Use the Duffel Flights MCP in Windsurf

Use Windsurf to book flights directly through the Duffel Flights MCP server without leaving your IDE's terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Duffel Flights MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous flight booking with Windsurf

Cascade chains `create_flight_offer_request` and `create_flight_order` to handle your travel plans. You define the destination and passengers, then let the agent sequence the calls. It handles the state transitions required to move from an offer request to a confirmed booking. This means you skip the manual API wrangling.

Search global routes in Windsurf

Use `list_airports` and `list_airlines` to pull live data into your workspace. You get accurate codes and names before you even start the booking flow. Windsurf reads these lists to ensure your search parameters match the actual inventory. It keeps your development context clean and precise.

Manage orders via Windsurf

The `list_flight_orders` tool lets you check existing bookings right in your environment. You see exactly what is on the books without switching windows. If you need to finalize a hold, `pay_for_flight_order` completes the process. Everything stays inside your current session.

Setup guide

Set up Duffel Flights 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 Flights 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 Flights payment history." If connected, Cascade will call the Duffel Flights tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "duffel-flights-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 Flights 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 Flights MCP in Windsurf

Run an offer request through the MCP interface. Cascade will call `list_flight_offers` to show you the current pricing for your chosen route.

Yes, you use the booking tools directly. Once you select an offer, the agent executes the order creation and payment steps.

The server provides a dedicated list tool for this. You just invoke `list_flight_orders` to pull your history into the chat panel.

It processes passenger details and flight preferences you provide. The server only transmits the specific data needed to complete your booking requests.

The connection uses encrypted endpoints for all transactions. No raw credit card data stays in your local environment logs after the call completes.

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