United Airlines MCP Server for Mastra AI 12 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect United Airlines through the Vinkius and Mastra agents discover all tools automatically — type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token — get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"united-airlines": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "United Airlines Agent",
instructions:
"You help users interact with United Airlines " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with United Airlines?"
);
console.log(result.text);
}
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.
Mastra's agent abstraction provides a clean separation between LLM logic and United Airlines tool infrastructure. Connect 12 tools through the Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution — deployable to any Node.js host in one command.
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 Mastra 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 Mastra AI via MCP
Follow these steps to integrate the United Airlines MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 12 tools from United Airlines via MCP
Why Use Mastra AI with the United Airlines MCP Server
Mastra AI provides unique advantages when paired with United Airlines through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure — add United Airlines without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every United Airlines tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host — Vercel, Railway, Fly.io, or your own infrastructure
United Airlines + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the United Airlines MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query United Airlines, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed United Airlines as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query United Airlines on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using United Airlines tools alongside other MCP servers
United Airlines MCP Tools for Mastra AI (12)
These 12 tools become available when you connect United Airlines to Mastra 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 Mastra AI
Ready-to-use prompts you can give your Mastra 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 Mastra AI
Common issues when connecting United Airlines to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpUnited Airlines + Mastra AI FAQ
Common questions about integrating United Airlines MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
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 Mastra AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.