How to Use the Gordian Software (Airline Ancillaries API) MCP in Pydantic AI

Q: How does Pydantic AI validate responses from the Gordian Software (Airline Ancillaries API) MCP Server?

The framework intercepts the output of tools like getsearchresults and parses them against predefined Pydantic models. Any schema mismatch triggers a runtime validation error, preventing silent failures.

Q: How do I configure the Gordian Software (Airline Ancillaries API) connection in Pydantic AI?

Use the MCPToolset constructor with your Vinkius HTTP endpoint. Pass this toolset directly into the Agent configuration to expose all 17 ancillary booking tools to your model.

Q: What happens if an airline cancels a flight in my Pydantic AI application?

The agent calls informcancelled to notify Gordian of the external cancellation. To reverse the booking, the agent uses requestrefund and tracks the refund status via getrefund.

Build type-safe airline booking workflows with Pydantic AI and the Gordian Software 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 Gordian Software (Airline Ancillaries API) MCP to Pydantic AI

Create your Vinkius account to connect Gordian Software (Airline Ancillaries API) 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 Gordian Software (Airline Ancillaries API) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe search with Pydantic AI

The `start_search` tool provides structured airline inventory queries that your Pydantic AI runtime validates instantly. This MCP Server ensures that every seat map and pricing payload matches your Python schemas. If the upstream API returns unexpected data formats, your agent fails immediately with a validation error rather than silently processing corrupt info. This strict validation ensures your application never writes invalid seat configurations to your database.

Strict basket validation and pricing checks

The `add_to_basket` tool appends baggage or seat items to the user's active session under strict type constraints. Pydantic AI enforces strict data models on the input arguments, ensuring that only valid product IDs and passenger details are sent to Gordian. After adding items, the agent runs `check_basket` to verify that the pricing remains accurate. Because the validation happens at the runtime level, you eliminate the risk of the model hallucinating invalid prices or booking codes.

Guaranteed trip updates and transactional safety

The `create_trip` tool registers the initial booking, which your agent can modify using `update_trip` to add PNRs. Every state transition is strictly typed, preventing your agent from passing incomplete passenger records during checkout. When executing final bookings, the agent calls `fulfill_trip` using your configured payment methods. If an external flight change occurs, tools like `inform_changed` update the state under strict schema boundaries.

Setup guide

Set up Gordian Software (Airline Ancillaries API) 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": {
        "gordian-software-airline-ancillaries-api-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Gordian Software (Airline Ancillaries API) tools.",
)

result = await agent.run("List recent Gordian Software (Airline Ancillaries API) 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 Gordian Software. 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 Gordian Software (Airline Ancillaries API) 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 Gordian Software (Airline Ancillaries API) MCP in Pydantic AI

The framework intercepts the output of tools like `get_search_results` and parses them against predefined Pydantic models. Any schema mismatch triggers a runtime validation error, preventing silent failures.

Use the `MCPToolset` constructor with your Vinkius HTTP endpoint. Pass this toolset directly into the `Agent` configuration to expose all 17 ancillary booking tools to your model.

Yes, Pydantic AI is model-agnostic, allowing you to run Gordian Software (Airline Ancillaries API) operations using local models or commercial APIs. The validation layer remains active regardless of the model you choose.

The agent calls `inform_cancelled` to notify Gordian of the external cancellation. To reverse the booking, the agent uses `request_refund` and tracks the refund status via `get_refund`.

All passenger names, passport details, and PNR codes are processed inside Vinkius's secure, ephemeral V8 isolates. This architecture ensures that sensitive booking data is never stored permanently or exposed to external LLM providers.

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