How to Use the Freshcaller MCP in OpenAI Agents SDK

Q: How to use Freshcaller with OpenAI Agents SDK for call reporting?

Your agent can call listaccountmetrics to get key performance indicators. For more detailed reports, you can have it listcalls and then process the log data to build custom summaries.

Q: Can I manage Freshcaller agents using the OpenAI Agents SDK?

Yes. The toolset exposes listagents to get your roster and getagentdetails to check on individuals. You can also see team structures with listagentteams and getteamdetails.

Q: How do I get call recordings from Freshcaller with an OpenAI agent?

First, find the call using listcalls. Once you have the call's ID, your agent can use the getcallrecording tool to fetch a direct link to the audio file. It's a two-step process that's easy to automate.

Connect your OpenAI Agents SDK to Freshcaller. Manage your call center with traceable, production-ready agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshcaller MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Your Support Staff

This toolset lets your agent act like a shift supervisor. You can get a full roster of your support staff with `list_agents` and then drill down into specific user data with `get_agent_details`. From there, you can check team assignments using `list_agent_teams` or get specifics on a group with `get_team_details`. It's what you need to build agents that can route tasks, check availability, or just give you a quick status update on who's active. This MCP server gives your agent direct access to that ground truth.

Audit Calls and Recordings

Stop digging through dashboards to find a specific call. Give your agent a date range and have it pull a log with `list_calls`. Find the one you need, and then grab its full metadata using `get_call_details`. If a recording exists, your agent can get a direct link to the audio file with `get_call_recording`. This is perfect for building automated QA systems or an agent that flags calls for review based on duration or other properties. It turns a manual search into a single command.

Automate Reporting with an MCP Server

Your agent gets direct access to high-level call center performance data. Use `list_account_metrics` to get a snapshot of things like average answer speed or total abandoned calls. It's the raw data you'd normally have to find in a report. Your agent can also manage your phone number inventory. It can check the numbers you own with `list_my_numbers` and then search for new ones to provision with `list_buyable_numbers`. This lets you build a bot that monitors call volume and suggests adding new lines when you're getting busy.

Setup guide

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

Create your Agent

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

Run the agent

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

Your agent can call `list_account_metrics` to get key performance indicators. For more detailed reports, you can have it `list_calls` and then process the log data to build custom summaries.

Yes. The toolset exposes `list_agents` to get your roster and `get_agent_details` to check on individuals. You can also see team structures with `list_agent_teams` and `get_team_details`.

First, find the call using `list_calls`. Once you have the call's ID, your agent can use the `get_call_recording` tool to fetch a direct link to the audio file. It's a two-step process that's easy to automate.

It's straightforward. After installing the OpenAI Agents SDK, you just instantiate an `MCPServerStreamableHttp` object with the Vinkius URL. Pass that server instance into your Agent's constructor in the `mcp_servers` list and the tools are discovered automatically.

Your data is protected at two levels. Vinkius runs each MCP server in an ephemeral, zero-trust sandbox, so no data is stored. The server only proxies your requests, touching Freshcaller data like agent details, call logs, and recording links in memory and only for the duration of the request.

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