How to Use the Ebby MCP in OpenAI Agents SDK

Q: How do I register the Ebby MCP Server in my OpenAI Agents SDK project?

Install the package via pip install openai-agents to begin. Initialize the server using MCPServerStreamableHttp with your connection URL, and pass it directly to the mcpservers list in your OpenAI Agents SDK constructor. Set cacheToolsList=True to keep OpenAI tool resolution for Ebby fast.

Q: Can my OpenAI Agents SDK assistant locate specific files using Ebby?

Yes, your OpenAI Agents SDK agent runs searchtranscriptionsbyname to find audio files by filename keywords. It then calls gettranscriptiondetails to retrieve specific configuration settings, keeping your Ebby file lookups entirely automated.

Q: What is the best way to handle long Ebby audio files in OpenAI Agents SDK?

Use listlatesttranscriptions to monitor the newest Ebby uploads and fetch text incrementally. Your OpenAI agent can process the resulting text blocks in chunks to fit within your OpenAI model's token limits.

Build production-ready OpenAI Agents SDK workflows that automatically trace, validate, and retrieve Ebby audio transcriptions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ebby MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track transcription lifecycle with OpenAI Agents SDK

Your OpenAI agent uses `list_in_progress_transcriptions` to monitor active processing queues directly within your agent run loops. It checks the status of pending files, ensuring your downstream analysis steps wait until the audio processing completes. Once the file status shifts, the agent calls `list_successfully_processed_audio` to pull the ready-to-export files. This prevents your OpenAI Agents SDK tools from requesting incomplete files, saving your API token budget and avoiding execution errors.

Run secure metadata audits using this MCP Server

This MCP Server exposes `quick_transcription_volume_audit` to let your agent inspect high-level usage rates and activity volume. Your OpenAI agent processes this data to check if your account is hitting processing limits before initiating heavy batches. The agent pairs this with `get_ebby_account_metadata` to verify your remaining plan limits. This keeps your production workflows within budget, handling errors gracefully through native OpenAI SDK guardrails.

Extract speaker details and text for downstream analysis

Your OpenAI agent invokes `get_transcription_text` to extract raw Ebby text content from completed files for immediate summarization. It feeds this text directly into your OpenAI agent's context window, allowing for instant analysis without manual file downloads. To map who said what in Ebby, the OpenAI agent runs `list_transcription_speakers` to associate identified voices with their corresponding dialogue segments. The OpenAI dashboard traces these Ebby tool calls step-by-step, making it easy to debug speaker mapping issues in production.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the package via `pip install openai-agents` to begin. Initialize the server using `MCPServerStreamableHttp` with your connection URL, and pass it directly to the `mcp_servers` list in your OpenAI Agents SDK constructor. Set `cacheToolsList=True` to keep OpenAI tool resolution for Ebby fast.

Yes, your OpenAI Agents SDK agent runs `search_transcriptions_by_name` to find audio files by filename keywords. It then calls `get_transcription_details` to retrieve specific configuration settings, keeping your Ebby file lookups entirely automated.

This MCP Server relies on the OpenAI Agents SDK built-in guardrails to validate tool schemas before execution. If your OpenAI agent attempts to fetch Ebby text for an unprocessed file, the validation layers catch the error before the API request goes out.

Use `list_latest_transcriptions` to monitor the newest Ebby uploads and fetch text incrementally. Your OpenAI agent can process the resulting text blocks in chunks to fit within your OpenAI model's token limits.

All Ebby transcription text and speaker metadata pass through an isolated V8 sandbox on Vinkius. Your OpenAI Agents SDK API keys are encrypted at rest, and no Ebby audio data is stored on our servers after the tool execution completes.

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