How to Use the Thoughtly MCP in OpenAI Agents SDK

Q: How do I connect the OpenAI Agents SDK to my Thoughtly MCP server?

You'll use MCPServerStreamableHttp and pass the server instance into your Agent's constructor. Set cacheToolsList=True so your agent doesn't have to re-discover the tools on every run. It's a one-time setup.

Build production voice agents on the OpenAI Agents SDK that manage contacts and make calls for you. This is not a prototype.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Thoughtly MCP to OpenAI Agents SDK

Create your Vinkius account to connect Thoughtly to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Thoughtly with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage Your CRM From Code

Your agent can build and maintain its own contact list. Use `create_contact` to add new leads, or pull your entire address book with `list_contacts`. It's a direct line into your CRM, managed by your agent. When details change, your agent can run `update_contact` to keep records fresh or `delete_contact` when a lead goes cold. Your agent gets a specific person's info using `get_contact` before it acts. This isn't just a data dump; it's an active CRM your agent controls.

Trigger Calls and Check History

This is the core action. Your agent uses `trigger_call` to place an outbound call to any contact. No more manual dialing. The agent does the work, you see the results. After the call, you can pull the entire interaction. Have your agent use `list_calls` to see recent activity, then dig into a specific conversation with `get_call_history` to get the full transcript and metadata. It's all logged and accessible.

Control Your Thoughtly MCP Server

Your agents need to know who they are and what they're doing. `get_user` gives your agent its own identity within the Thoughtly system. It's how it authenticates and logs its own actions. You can also manage the voice agents themselves. `list_interviews` shows you all the configured voice agent personalities, and `get_interview` lets your agent inspect a specific one before deciding which to use for a call. This gives you programmatic control over the voice experience.

Setup guide

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

Create your Agent

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

Run the agent

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

You'll use `MCPServerStreamableHttp` and pass the server instance into your Agent's constructor. Set `cacheToolsList=True` so your agent doesn't have to re-discover the tools on every run. It's a one-time setup.

Yes, that's a primary function. Your agent can create, read, update, and delete contacts using the built-in Thoughtly tools. It's how you give your agent a list of people to call.

Absolutely. Since the OpenAI Agents SDK auto-discovers the Thoughtly tools, its built-in validation and guardrails apply automatically. You can define which actions require confirmation before your agent executes them.

The SDK is designed for this. You can create specialized agents—one for lead qualification, another for appointment setting—and use the handoff features. Each agent can use the same Thoughtly MCP connection, but focus on different tasks.

The server only processes contact details like names and phone numbers, plus call metadata and transcripts you generate. Vinkius runs each MCP Server in a zero-trust, ephemeral sandbox. Your connection is secured by your unique endpoint token, and the data is only held for the duration of the API call.

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