United Airlines MCP Server for Pydantic AI 12 tools — connect in under 2 minutes
Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect United Airlines through the Vinkius and every tool is automatically validated against Pydantic schemas — catch errors at build time, not in production.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
async def main():
# Your Vinkius token — get it at cloud.vinkius.com
server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
agent = Agent(
model="openai:gpt-4o",
mcp_servers=[server],
system_prompt=(
"You are an assistant with access to United Airlines "
"(12 tools)."
),
)
result = await agent.run(
"What tools are available in United Airlines?"
)
print(result.data)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About United Airlines MCP Server
Connect United Airlines flight data to any AI agent and gain instant visibility into live flight tracking, airport schedules, route networks, delays, and aircraft fleet information through natural conversation.
Pydantic AI validates every United Airlines tool response against typed schemas, catching data inconsistencies at build time. Connect 12 tools through the Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code — full type safety, structured output guarantees, and dependency injection for testable agents.
What you can do
- Live Flight Tracking — Get real-time status for any United Airlines flight by flight number, including gate, terminal, baggage belt, and current operational status (scheduled, active, landed, delayed, cancelled)
- Airport Departures & Arrivals — List all United flights departing from or arriving at any airport worldwide, filterable by date
- Route Network Analysis — Explore United's complete route map, check if United operates between specific airports, and analyze route coverage across their global network
- Historical Flight Data — Analyze past flight performance, check delays and cancellations on specific dates, review on-time patterns
- Future Flight Schedules — View planned United flight schedules for upcoming dates to plan travel or monitor operations
- Flight Status Filtering — Find all delayed, cancelled, or disrupted United flights at any airport to assess operational impacts
- Airport & Airline Details — Retrieve detailed information about airports served by United and carrier metadata
- Aircraft Fleet Info — Access data about aircraft types and fleet composition associated with United Airlines
The United Airlines MCP Server exposes 12 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect United Airlines to Pydantic AI via MCP
Follow these steps to integrate the United Airlines MCP Server with Pydantic AI.
Install Pydantic AI
Run pip install pydantic-ai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.py and run: python agent.py
Explore tools
The agent discovers 12 tools from United Airlines with type-safe schemas
Why Use Pydantic AI with the United Airlines MCP Server
Pydantic AI provides unique advantages when paired with United Airlines through the Model Context Protocol.
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
Model-agnostic architecture — switch between OpenAI, Anthropic, or Gemini without changing your United Airlines integration code
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
Dependency injection system cleanly separates your United Airlines connection logic from agent behavior for testable, maintainable code
United Airlines + Pydantic AI Use Cases
Practical scenarios where Pydantic AI combined with the United Airlines MCP Server delivers measurable value.
Type-safe data pipelines: query United Airlines with guaranteed response schemas, feeding validated data into downstream processing
API orchestration: chain multiple United Airlines tool calls with Pydantic validation at each step to ensure data integrity end-to-end
Production monitoring: build validated alert agents that query United Airlines and output structured, schema-compliant notifications
Testing and QA: use Pydantic AI's dependency injection to mock United Airlines responses and write comprehensive agent tests
United Airlines MCP Tools for Pydantic AI (12)
These 12 tools become available when you connect United Airlines to Pydantic AI via MCP:
get_aircraft_fleet
Returns aircraft types, registration numbers, and other fleet details. Use this when users want to understand the types of aircraft United Airlines operates or find information about specific aircraft in their fleet. This provides static fleet composition data, not real-time aircraft positioning. Get information about United Airlines aircraft fleet
get_airline_info
Use this to get basic information about United Airlines as a carrier. This is primarily useful for verifying airline codes or getting carrier metadata. Get detailed information about United Airlines
get_airline_routes
Returns all origin-destination airport pairs that United serves. Each route includes departure airport IATA code, arrival airport IATA code, and codeshare information if applicable. Use this to understand the full reach of United Airlines network, analyze route coverage, or find if United flies between two cities. This provides static route data, not flight schedules or availability. List all routes operated by United Airlines (origin-destination pairs)
get_airport_info
Returns airport name, city, country, geographic coordinates, timezone, and other relevant details. Use this when users need airport details such as the full name, location, or to verify an airport code. The airport IATA code is required (e.g., "ORD" for Chicago O'Hare, "NRT" for Tokyo Narita). Get detailed information about an airport served by United Airlines
get_arrivals
g., "JFK" for New York JFK, "LAX" for Los Angeles). Optionally filter by date (YYYY-MM-DD format) to see arrivals on a specific day. Returns flight numbers, origin airports, scheduled times, gates, terminals, baggage belts, and current arrival status. Use this when users want to track incoming United flights at a particular airport or check when a flight from a specific origin arrives. List all United Airlines arrivals at a specific airport
get_departures
g., "SFO" for San Francisco, "EWR" for Newark). Optionally filter by date (YYYY-MM-DD format) to see departures on a specific day. Returns flight numbers, destinations, scheduled times, gates, terminals, and current departure status. Use this when users want to see all United flights leaving from a particular airport on a given day. Common United hubs include: EWR (Newark), ORD (Chicago), IAH (Houston), DEN (Denver), SFO (San Francisco), LAX (Los Angeles), IAD (Washington Dulles), LHR (London Heathrow). List all United Airlines departures from a specific airport
get_flight_by_number
This is useful for finding the regular schedule and route of a flight number (e.g., which airports UA1 serves). Returns flight schedule information including departure/arrival airports and times. Use this to understand the typical route and schedule of a specific United flight number. Search for United Airlines flights by flight number across all dates and routes
get_flight_history
Returns actual departure/arrival times, delays, cancellations, and flight outcomes. Use this to analyze past flight performance, check if a flight was delayed or cancelled on a specific date, or review on-time performance. The date must be in YYYY-MM-DD format and should be a past date. Specify "departure" or "arrival" for the type parameter. Get historical United Airlines flight data for a past date
get_flight_status
g., "123" for UA123). Returns departure/arrival airports, scheduled/estimated times, gate, terminal, baggage belt, and current flight status (scheduled, active, landed, cancelled, etc). Use this tool when a user asks about the current status of a specific United flight. The flight number should be just the digits, without the "UA" prefix. Get real-time status of a specific United Airlines flight by flight number (e.g., UA123)
get_flights_by_status
Status values include: "scheduled", "active", "landed", "cancelled", "delayed", "diverted", etc. Use this when users want to see all delayed flights, cancelled flights, or flights in a particular state at an airport. Specify the airport IATA code, the status filter, and whether to check departures or arrivals. This is particularly useful for finding disrupted flights or checking operational impacts at an airport. Find United Airlines flights at an airport with a specific status (delayed, cancelled, active, etc)
get_future_flights
Returns planned departure or arrival information including flight numbers, times, gates, and aircraft types. Use this to check upcoming flight schedules, plan travel, or see which United flights will operate on a future date. The date must be in YYYY-MM-DD format and should be a future date. Specify "departure" or "arrival" for the type parameter. Get scheduled United Airlines flights at an airport for a future date
get_route
Returns route details including whether it is a direct route, codeshare arrangements, and flight frequency if available. Use this when users ask "Does United fly from X to Y?" or want to verify route availability between two airports. Both airport IATA codes are required (e.g., fromIata="SFO", toIata="LHR" for San Francisco to London Heathrow). Check if United Airlines operates a route between two specific airports
Example Prompts for United Airlines in Pydantic AI
Ready-to-use prompts you can give your Pydantic AI agent to start working with United Airlines immediately.
"What's the current status of United flight UA234?"
"Show me all United Airlines departures from San Francisco (SFO) today."
"Are there any delayed United arrivals at Chicago O'Hare (ORD) right now?"
Troubleshooting United Airlines MCP Server with Pydantic AI
Common issues when connecting United Airlines to Pydantic AI through the Vinkius, and how to resolve them.
MCPServerHTTP not found
pip install --upgrade pydantic-aiUnited Airlines + Pydantic AI FAQ
Common questions about integrating United Airlines MCP Server with Pydantic AI.
How does Pydantic AI discover MCP tools?
MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.Does Pydantic AI validate MCP tool responses?
Can I switch LLM providers without changing MCP code?
Connect United Airlines with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect United Airlines to Pydantic AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.