How to Use the Aircall MCP in OpenAI Agents SDK

Q: Is there a performance hit when using Aircall with the OpenAI Agents SDK?

Not really. For best performance, set cacheToolsList=True when you initialize the agent. This prevents the SDK from fetching the tool list from the MCP server on every run.

Give your production OpenAI agent direct, guarded access to manage Aircall contacts, calls, and users with the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aircall MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Contacts with Built-in Guardrails

Let your agent handle Aircall contacts directly. It can look up contacts with `list_contacts` or `search_contacts` and add new ones using `create_contact`. You don't have to write any boilerplate API code. The OpenAI Agents SDK gives you guardrails out of the box. You can configure rules that prevent the agent from taking unwanted actions. This means you can deploy it to production and trust it won't accidentally delete your entire contact list.

Give Agents Full Aircall Context

Your agent can see what's happening inside Aircall. It can pull call history with `list_calls` or check the technical details of a specific call using `get_call_details`. This is great for summarizing activity or flagging calls for follow-up. Agents can also check team member status with `get_user_details` to see who's available. Every action is logged in the OpenAI dashboard, so you have a full trace of what your agent did with the Aircall data.

Audit Your Aircall Setup with an MCP Server

This isn't just for day-to-day tasks. You can build agents that perform administrative checks on your Aircall account. Have an agent run `list_numbers` and `get_number_details` to confirm your phone numbers are configured correctly. It can also inventory your organization by pulling data with `list_teams` and `list_users`. Because the tools are auto-discovered, setup is minimal. Just point the SDK at the Vinkius MCP Server endpoint and your agent is ready to go.

Setup guide

Set up Aircall 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 Aircall tools at runtime.
3

Create your Agent

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

Run the agent

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

You instantiate the MCPServerStreamableHttp class with your Vinkius endpoint URL. Pass that server object into the Agent constructor's `mcp_servers` list. The agent discovers all the Aircall tools automatically.

That's up to you. The OpenAI Agents SDK has built-in guardrails that let you define what an agent can and can't do. You can require human confirmation for specific actions like creating contacts.

It's a perfect fit. You can have one agent that's an expert at customer support using Aircall tools, and another for sales. The SDK's handoff feature lets the sales agent pass a task, like logging a call, to the support agent.

Not really. For best performance, set `cacheToolsList=True` when you initialize the agent. This prevents the SDK from fetching the tool list from the MCP server on every run.

Your data is only passed through for the specific tool you invoke. Vinkius uses an ephemeral, zero-trust environment to process requests to the Aircall MCP Server. No contact information or call log data is stored.

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