How to Use the Duffel Flights MCP in Pydantic AI

Q: How do I initialize the Duffel Flights MCP Server in Pydantic AI?

Install the library using pip install "pydantic-ai-slimmcp" and instantiate MCPToolset with your Vinkius MCP server URL. Pass this toolset into the Agent constructor's toolsets parameter to auto-discover the booking endpoints.

Q: How do I handle expired flight offers in Pydantic AI?

When listflightoffers returns an offer that expires, your agent can catch the validation or API error. You can write a Pydantic AI dependency that automatically triggers a new createflightofferrequest to fetch active ticket prices.

Build type-safe, validated booking agents with Pydantic AI and Duffel Flights.

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 Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate flight searches using Pydantic AI

Generating a structured search query for flights based on origin, destination, and passenger counts is exactly what the `create_flight_offer_request` tool does. Pydantic AI enforces strict typing on this payload at runtime, ensuring your agent never sends malformed date formats or invalid airport codes to the Duffel API. Once the request is sent, the agent calls `list_flight_offers` to parse the returned ticket options. Because Pydantic AI validates every field against your schemas, any unexpected API changes will raise an immediate, catchable validation error instead of corrupting your booking flow.

Execute flight bookings with this MCP Server

The `create_flight_order` tool takes passenger details and selected offer IDs to create a pending booking on the airline's GDS. Your Pydantic AI agent validates the passenger's name, date of birth, and contact info against strict schemas before initiating the API call. Paying for the finalized reservation occurs when the agent calls `pay_for_flight_order` to run the transaction. This guarantees that credit card details or payment tokens are fully validated and formatted correctly before hitting the external billing gateway.

Verify airports and fleets in Pydantic AI

Real-time validation of airport IATA codes and locations during user input is handled by the `list_airports` tool. Pydantic AI uses this tool to check that the user's origin and destination are valid airports before running a flight search. Your agent can also query `list_airlines` and `list_aircraft` to retrieve carrier names and plane configurations. This metadata is parsed into strongly-typed Python models, making it easy to display seat layouts or baggage rules to the user.

Setup guide

Set up Duffel Flights MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "duffel-flights-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Duffel Flights tools.",
)

result = await agent.run("List recent Duffel Flights transactions")
print(result.output)

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 Pydantic AI

Install the library using `pip install "pydantic-ai-slim[mcp]"` and instantiate `MCPToolset` with your Vinkius MCP server URL. Pass this toolset into the `Agent` constructor's `toolsets` parameter to auto-discover the booking endpoints.

Flight booking APIs are notoriously complex, but Pydantic AI guarantees that payloads for tools like `create_flight_order` match the expected schema exactly. If the agent hallucinates a passenger field, the runtime validation catches it instantly and forces a retry.

When `list_flight_offers` returns an offer that expires, your agent can catch the validation or API error. You can write a Pydantic AI dependency that automatically triggers a new `create_flight_offer_request` to fetch active ticket prices.

Yes, Pydantic AI is completely model-agnostic. You can connect your Vinkius-hosted MCP server to local models or alternative APIs, and the runtime schema validation will still protect your booking pipeline from hallucinations.

Sensitive passenger names, passport details, and payment tokens are passed directly to Duffel through the MCP pipeline into Vinkius's secure, zero-trust V8 isolate sandbox. Pydantic AI validates this data purely in-memory, ensuring that no unencrypted personal identifiable information (PII) is written to logs or persistent databases.

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