How to Use the Goodcall MCP in OpenAI Agents SDK
Build production-grade receptionists with OpenAI Agents SDK. Connect Goodcall tools to your agent for instant, reliable call handling.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Goodcall MCP to OpenAI Agents SDK
Create your Vinkius account to connect Goodcall 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.
Full agent control over Goodcall calls
Your agent manages every conversation directly. Use `get_call` and `get_transcript` to feed live data into your system, ensuring your agent knows exactly what happened on every line. It doesn't stop at reading. You can use `update_agent` to change receptionist behavior on the fly, tailoring your phone presence without touching a line of code.
Automated booking and status verification
Stop worrying about missed appointments. The agent pulls data via `list_bookings` to keep your calendar synced and accurate. Integrate `check_goodcall_status` into your initialization flow. It's the standard way to verify that your Goodcall connection is live before the agent starts taking requests.
Deep analytics for your OpenAI agent
Feed call performance back into your training loop. Use `get_analytics` to pull raw numbers, then process them with `list_calls_by_agent` to see how specific configurations perform. This data lets you build agents that actually learn from their own history. It turns your telephony stack into a measurable asset.
Set up Goodcall MCP in OpenAI Agents SDK
Prerequisites
- Python 3.10+ installed
-
openai-agentspackage (pip install openai-agents) - Active Vinkius subscription with a valid endpoint token
- 1
Install the SDK
Run
pip install openai-agentsto install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed. - 2
Connect via SSE transport
Use
MCPServerSsewith your Vinkius endpoint URL. Replace[YOUR_TOKEN_HERE]with your token from cloud.vinkius.com. The SDK auto-discovers all Goodcall tools at runtime. - 3
Create your Agent
Pass the MCP to
Agent(mcp_servers=[server]). The agent receives Goodcall tools as native definitions — JSON schemas resolve automatically. - 4
Run the agent
Call
Runner.run(agent, prompt)to execute. The agent invokes the appropriate Goodcall tools and returns structured results. Copy the full example on the right to get started.
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="Goodcall Agent",
instructions="You have access to Goodcall tools.",
mcp_servers=[server],
)
result = await Runner.run(agent, "List recent transactions")
print(result.final_output)
asyncio.run(main()) Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Goodcall. 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.
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 Goodcall MCP in OpenAI Agents SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Goodcall MCP today
We host it, we monitor it, we maintain it. You just paste one token.