How to Use the GPTBots MCP in OpenAI Agents SDK

Connect GPTBots to your OpenAI Agents SDK projects to run workflows and manage knowledge bases directly from your production code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GPTBots MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate agent workflows with precision

Trigger complex bot logic directly from your agent loop. You call `trigger_workflow` to start a process, then use `query_workflow` to check the status of that execution without leaving your Python environment. This keeps your agent logic clean. Instead of polling external APIs manually, you let the tool handle the state checking, ensuring your production agents stay focused on the task at hand.

Manage knowledge base documentation

Feed your agents fresh information by using `create_knowledge_document`. When you need to see what your bots already know, call `list_knowledge_documents` to audit the existing library. Your agents maintain context by accessing these records in real-time. It turns raw documentation into a searchable asset that your OpenAI Agents SDK agent can reference during live conversations.

Control agent conversation history

Retrieve past interactions to analyze bot performance using `get_conversation`. You can also pull a full index of chat threads with `list_conversations` to see exactly what your users are asking. This data visibility allows you to track agent behavior across sessions. By integrating these tools, your OpenAI Agents SDK setup gains a clear audit trail for every message processed.

Setup guide

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

Create your Agent

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

Run the agent

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

You manage security via your Vinkius endpoint token. The MCP server restricts access to `list_databases` and other sensitive tools based on the credentials you provide during initialization.

Yes. The server returns standard error codes for failed requests. You catch these in your Python code just like any other exception to prevent your agent from stalling.

Performance depends on your network latency to the Vinkius hosting environment. By setting cacheToolsList=True, you minimize overhead during agent startup.

Your data remains within your account infrastructure. The MCP server only acts as a bridge for your agent to execute commands like `send_bot_message` when you specifically invoke them.

The tools are fully compatible. Your agent's internal guardrails will inspect every tool output from the server before it reaches the final stage of your pipeline.

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