How to Use the IATA Developer Portal MCP in OpenAI Agents SDK

Q: How do I initialize the IATA Developer Portal tools in the OpenAI Agents SDK?

Install openai-agents and pass the HTTP streamable URL into your agent constructor. The SDK automatically parses the schema for checkapistatus and the other five tools. You do not need to write any custom Python functions to glue the APIs together.

Q: How does caching work in the OpenAI Agents SDK when querying aircraft codes?

Set cacheToolsList=True in your Python setup to store the tool definitions locally. This prevents the SDK from refetching the tool definitions on every turn, speeding up tools like searchaircraft.

Get clean aviation reference data in your production OpenAI Agents SDK pipelines with zero-config MCP tool discovery.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IATA Developer Portal MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-discover aviation tools with OpenAI Agents SDK

Drop the Vinkius endpoint into your HTTP streamable configuration. Your agents instantly find and register `search_airports` and `search_airlines` without you writing manual JSON schemas. This setup lets your system check flight hubs or routing options on the fly. You bypass the usual boilerplate and let the agent query the IATA Developer Portal directly when a user asks about flight options.

Run safe aviation lookups with native guardrails

Avoid bad inputs before they hit your production systems. Your agent uses `get_city_details` to verify locations, while built-in OpenAI safety guardrails intercept and inspect the arguments before execution. If a user inputs a mangled code, the agent catches it early. This MCP Server integration ensures your pipeline only queries real, validated IATA codes, protecting your API quotas from wasted calls.

Route airport queries via specialized agent handoffs

Build a multi-agent system where one agent handles carrier lookups and another manages terminal data. You can send tasks to the airline expert agent to run `search_aircraft` while another handles airport lookups. Trace every single tool call directly inside your OpenAI dashboard. When an agent calls `list_iata_countries`, you see the exact latency and token cost without guessing.

Setup guide

Set up IATA Developer Portal 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 IATA Developer Portal tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate IATA Developer Portal 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="IATA Developer Portal Agent",
            instructions="You have access to IATA Developer Portal 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 IATA Developer Portal. 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 IATA Developer Portal 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 IATA Developer Portal MCP in OpenAI Agents SDK

Install `openai-agents` and pass the HTTP streamable URL into your agent constructor. The SDK automatically parses the schema for `check_api_status` and the other five tools. You do not need to write any custom Python functions to glue the APIs together.

Yes, you can route tasks between specialized agents. One agent can run `search_airlines` to identify a carrier, then hand off the context to another agent that calls `search_airports` to map the route.

No, you do not need to write any manual schemas. The MCP Server handles schema transmission automatically over the secure connection. Your agents discover the endpoints instantly upon startup.

Set `cacheToolsList=True` in your Python setup to store the tool definitions locally. This prevents the SDK from refetching the tool definitions on every turn, speeding up tools like `search_aircraft`.

All lookups for airport and airline codes run in a zero-trust, ephemeral V8 isolate sandbox. This MCP setup ensures your API keys and search parameters never persist on Vinkius servers, keeping your business intelligence private.

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