AirLabs MCP Server for OpenAI Agents SDK 12 tools — connect in under 2 minutes
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect AirLabs through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="AirLabs Assistant",
instructions=(
"You help users interact with AirLabs. "
"You have access to 12 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from AirLabs"
)
print(result.final_output)
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 AirLabs MCP Server
Connect your AirLabs Data API aviation platform to any AI agent and take full control of real-time flight tracking, airport intelligence, airline research, and schedule analysis through natural conversation.
The OpenAI Agents SDK auto-discovers all 12 tools from AirLabs through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries AirLabs, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Real-Time Flight Tracking — Search active flights worldwide by airline, flight number, aircraft registration, or geographic area
- Flight Schedules — Access complete timetables for airlines and airport pairs with frequency and days of operation
- Flight Information — Get detailed status for specific flights including gates, terminals, and timing data
- Airport Database — Search 50,000+ airports worldwide by country, city, IATA/ICAO code, or name
- Airline Database — Research airlines globally with fleet sizes, hub airports, and operational status
- Route Networks — Analyze complete route portfolios for any airline with origin-destination pairs
- Fleet Composition — Examine airline fleets with aircraft types, registrations, ages, and operational status
- Nearby Airports — Find airports near any geographic coordinate with distance calculations
- Airport Delays — Check current delay statistics and on-time performance for any airport
- Aircraft Lookup — Research individual aircraft by hex code with registration and specification details
- Airport Autocomplete — Quick airport search with type-ahead suggestions for user-friendly identification
- Airport Flight Boards — Monitor all arrivals or departures at any airport with complete flight lists
The AirLabs MCP Server exposes 12 tools through the Vinkius. Connect it to OpenAI Agents SDK 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 AirLabs to OpenAI Agents SDK via MCP
Follow these steps to integrate the AirLabs MCP Server with OpenAI Agents SDK.
Install the SDK
Run pip install openai-agents in your Python environment
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com
Run the script
Save the code above and run it: python agent.py
Explore tools
The agent will automatically discover 12 tools from AirLabs
Why Use OpenAI Agents SDK with the AirLabs MCP Server
OpenAI Agents SDK provides unique advantages when paired with AirLabs through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
AirLabs + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the AirLabs MCP Server delivers measurable value.
Automated workflows: build agents that query AirLabs, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries AirLabs, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through AirLabs tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query AirLabs to resolve tickets, look up records, and update statuses without human intervention
AirLabs MCP Tools for OpenAI Agents SDK (12)
These 12 tools become available when you connect AirLabs to OpenAI Agents SDK via MCP:
autocomplete_airport
Returns matching airports ranked by relevance with IATA/ICAO codes, full names, cities, countries, and airport types. Ideal for building airport search interfaces, type-ahead functionality, and airport identification when the user only knows part of the airport name or code. Essential for travel application development, airport search workflows, and user-friendly airport identification. AI agents should use this when users type partial airport names or codes and need quick suggestions, or when the exact airport code is unknown but a partial name is provided. Search airports by name or code with autocomplete suggestions
get_aircraft
Returns aircraft registration number, ICAO type code, manufacturer and model, owner/operator, registration country, year built, engine type and count, and current operational status. The hex code is a unique identifier assigned to each aircraft transponder and can be found in flight tracking data. Essential for aviation enthusiasts, aircraft tracking, fleet verification, and detailed aircraft research. AI agents use this when users have an aircraft hex code from flight tracking data and need to look up the full aircraft registration and specifications. Get information about a specific aircraft by hex code
get_airline_fleet
Returns all aircraft in the airline fleet with registration numbers, aircraft types (manufacturer and model), ICAO aircraft type codes, age in years, delivery dates, engine types, and current operational status (active, stored, retired). Essential for fleet analysis, aviation industry research, competitor intelligence, aircraft utilization studies, and airline operational profiling. AI agents use this when users ask "show me the Delta fleet", "what aircraft does Emirates operate", or need to analyze fleet composition, average fleet age, and aircraft diversity for a specific airline. Get the complete fleet composition of an airline
get_airline_routes
Returns route pairs (origin-destination airports), frequency of service, days of operation, aircraft types deployed on each route, and whether the route is seasonal or year-round. Essential for route network analysis, airline competitive intelligence, aviation market research, travel itinerary planning, and airline hub/spoke structure analysis. AI agents should reference this when users ask "show me all United routes", "what routes does Ryanair operate", or need to understand an airline route network for competitive analysis or travel planning. Get all routes operated by a specific airline
get_airlines
Supports filtering by country code, IATA code, ICAO code, airline name, or callsign. Returns airline details including IATA/ICAO codes, full name, country of registration, callsign, fleet size, founding year, hub airports, airline type (scheduled, cargo, charter), and operational status (active, inactive). Essential for airline industry research, competitor analysis, travel planning context, aviation market intelligence, and airline profile generation. AI agents should use this when users ask "show me all airlines in the US", "tell me about Lufthansa", "what airlines fly from Dubai", or need airline metadata to contextualize flight and fleet data. Search and retrieve airline database information
get_airport_delays
Returns average departure and arrival delays in minutes, delay trends compared to historical averages, on-time performance percentages, cancellation rates, and weather-related delay indicators. Essential for travel planning, delay prediction, passenger communication, airline operations coordination, and airport performance monitoring. AI agents should reference this when users ask "are there delays at JFK", "how is LAX performing today", or need to assess airport operational conditions that may affect flight schedules. Get current delay statistics for a specific airport
get_airports
Supports filtering by country code, city name, IATA code, ICAO code, airport name, or timezone. Returns airport details including IATA/ICAO codes, full name, location (city, state, country), geographic coordinates (latitude, longitude, elevation), timezone, airport type (large, medium, small), and operational status. Essential for airport identification, travel planning, geographic aviation research, multi-airport city analysis, and flight briefing preparation. AI agents should reference this when users ask "show me all airports in Germany", "find airports in Tokyo", "what is the ICAO code for Heathrow", or need airport metadata to contextualize flight queries. Search and retrieve airport database information
get_flight_info
g., "UA123" for United 123). Returns complete flight details including airline information, aircraft type and registration, departure and arrival airports with terminals and gates, scheduled and estimated/actual times, current flight status, delay indicators, and baggage claim information. Critical for passenger travel updates, detailed flight status queries, airline operations coordination, and travel itinerary verification. AI agents should use this when users ask "tell me about flight UA123", "what is the status of BA178", or need detailed information for a specific flight number. Get detailed information for a specific flight
get_flights
Supports filtering by airline IATA code (e.g., "UA" for United), flight number, aircraft registration (hex code), altitude range, speed, or geographic bounding box (lat/lng coordinates). Returns flight identification (flight IATA/ICAO codes), airline details, aircraft hex code and registration, departure and arrival airports with IATA/ICAO codes, scheduled and estimated/actual times, current position (latitude, longitude), altitude in meters, ground speed in km/h, heading direction, vertical speed, squawk code, and flight status (en-route, landed, scheduled, cancelled). Essential for real-time flight tracking, passenger pickup coordination, aviation operations monitoring, and live flight dashboards. AI agents should use this when users ask "show me all United flights", "track flights in this area", or need to search flights by airline, registration, or geographic area. Search for real-time active flights worldwide
get_flights_by_airport
Returns comprehensive flight lists with airline, flight number, aircraft type, origin/destination airport, scheduled and estimated/actual times, terminal and gate information, baggage claim (for arrivals), and current flight status (en-route, landed, scheduled, delayed, cancelled, diverted). Supports type parameter to filter by "departure" or "arrival" flights. Essential for airport operations management, passenger pickup coordination, ground handling planning, flight activity monitoring, and arrival/departure board displays. AI agents should reference this when users ask "what flights are departing from JFK", "show me all arrivals at LHR", or need to monitor airport traffic for a specific airport. Get all arriving or departing flights at a specific airport
get_nearby_airports
Returns all airports (large international, regional, and general aviation) within the search radius with distances from the coordinate, IATA/ICAO codes, names, locations, and airport types. Essential for travel planning, alternate airport identification, geographic aviation research, emergency diversion planning, and multi-airport city analysis. AI agents should use this when users ask "what airports are near these coordinates", "find airports within 100km of this location", or need to identify the nearest airports to a specific point for travel or logistics purposes. Find airports near a specific geographic location
get_schedules
Returns scheduled flights with airline, flight number, aircraft type, departure and arrival airports, scheduled times, frequency of service, days of operation, and aircraft registration if assigned. Supports filtering by airline IATA code, departure airport IATA, arrival airport IATA, date range, and flight number. Essential for travel planning, route analysis, schedule reliability studies, airline timetable research, and flight itinerary preparation. AI agents should reference this when users ask "what is the schedule from JFK to LAX", "show me all Delta flights from ATL", or need to analyze flight schedules between airports. Get flight schedules and timetables for airlines and airports
Example Prompts for AirLabs in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with AirLabs immediately.
"Show me all active United Airlines flights right now with their current positions and destinations."
"What is the flight schedule from New York JFK to London Heathrow, and which airlines operate this route?"
"Are there any delays at Chicago O'Hare (ORD) right now, and what flights are currently departing?"
Troubleshooting AirLabs MCP Server with OpenAI Agents SDK
Common issues when connecting AirLabs to OpenAI Agents SDK through the Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
AirLabs + OpenAI Agents SDK FAQ
Common questions about integrating AirLabs MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Connect AirLabs 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 AirLabs to OpenAI Agents SDK
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.