How to Use the Aviationstack MCP in OpenAI Agents SDK

Q: How do I connect Aviationstack to my project using the OpenAI Agents SDK?

First, pip install openai-agents. Then create an MCPServerStreamableHttp instance pointing to your Vinkius URL. Pass that server object into the mcpservers list when you initialize your Agent. The tools are discovered automatically.

Q: What airport information can I get with Aviationstack in my OpenAI agent?

The listairports tool gives you everything from airport name and IATA/ICAO codes to timezone and country. Your agent can ask for an airport by code and get back a structured object with all the details.

Build production-ready aviation agents with the safety and tracing of the OpenAI Agents SDK. Get live flight data you can trust.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aviationstack MCP to OpenAI Agents SDK

Create your Vinkius account to connect Aviationstack to OpenAI Agents SDK 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 Aviationstack with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track Live Flights with Full Observability

Your agent can now access real-time flight data. Just ask it to find active flights, and it will use the `list_flights` tool to get current statuses, positions, and ETAs. It's not a black box—every tool call your agent makes is traced in the OpenAI dashboard, so you can see exactly what data it requested and received. This gives you a clear audit trail for debugging or monitoring. If an agent needs to understand connections, it can pull entire flight paths with `list_routes`. You'll know precisely which routes it looked up and why, making it simple to refine your agent's logic.

Analyze Airlines and Fleets with Guardrails

Go beyond single flights and have your agent analyze entire airlines. It can pull operator details with `list_airlines` or get specs for specific aircraft using `list_aircraft_types` and `list_airplanes`. The data is structured and ready for analysis. The OpenAI Agents SDK lets you define guardrails to prevent unexpected behavior. You can constrain your agent to only query certain airlines or aircraft models, ensuring it stays on task. This is how you move from a simple chatbot to a reliable production system.

Build Logistics Workflows with this MCP Server

Connect your agent to a global database of aviation infrastructure. It can look up airport details using `list_airports`, find associated cities with `list_cities`, or check country codes via `list_countries`. The information is there for the asking. This MCP Server enables complex agent workflows. For example, one agent can specialize in finding the nearest airport, then hand off to another agent to check for available flights. The tools are automatically discovered, so you just point your agent at the Vinkius endpoint and it figures out the rest.

Setup guide

Set up Aviationstack MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Aviationstack tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Aviationstack tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Aviationstack tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Aviationstack Agent",
            instructions="You have access to Aviationstack tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Aviationstack. 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 Aviationstack 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 Aviationstack MCP in OpenAI Agents SDK

First, `pip install openai-agents`. Then create an `MCPServerStreamableHttp` instance pointing to your Vinkius URL. Pass that server object into the `mcp_servers` list when you initialize your `Agent`. The tools are discovered automatically.

Yes, the tools accept parameters. For instance, your agent can call `list_flights` and specify an airline IATA code or flight number to narrow down the results. The agent learns these parameters from the tool's schema.

The `list_airports` tool gives you everything from airport name and IATA/ICAO codes to timezone and country. Your agent can ask for an airport by code and get back a structured object with all the details.

Vinkius handles it for you. You get a single endpoint token that authenticates your agent with the managed MCP Server. You don't need to manage API keys for Aviationstack itself.

The server only processes the specific aviation data you request—flight numbers, airport codes, and airline names. Each request runs in a Vinkius zero-trust sandbox. The environment is ephemeral, meaning your query data is gone the instant the request is complete.

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