How to Use the Discord Bot MCP in OpenAI Agents SDK

Q: How do I link the Discord Bot to my OpenAI Agents SDK project?

You instantiate the server using MCPServerStreamableHttp with your Vinkius endpoint. Simply pass the server instance into your Agent constructor to expose the tools.

Manage Discord servers directly from your OpenAI Agents SDK workflow with precise, tool-backed control.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Discord Bot MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full Discord guild and channel oversight

Your agent inspects server structure using `list_guilds` and `list_channels` to identify where it needs to act. It gets specific channel details via `get_channel` to ensure it is targeting the correct environment before any changes occur. This MCP server gives your agent the context it needs to audit active discussions. By calling `get_guild`, the agent pulls metadata to verify it has the correct permissions for the current operation.

Automated message and member moderation

Cleanup becomes a background task when you connect this MCP server to your agent. The agent uses `list_messages` to scan for specific content, then triggers `delete_message` to remove non-compliant text instantly. Your agent maintains strict control over server membership as well. It calls `list_guild_members` to track who is present, while `get_guild_roles` allows the agent to check user status against existing server hierarchies.

Direct communication via OpenAI Agents SDK

Send updates or alerts to any channel using the `send_message` tool. Your agent formats the output based on its own analysis, ensuring the response fits the conversation flow perfectly. Everything happens securely through your agent's execution loop. The `get_me` tool confirms the bot's identity, providing a final check that the connection is active and authenticated before sending data.

Setup guide

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

Create your Agent

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

Run the agent

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

You instantiate the server using `MCPServerStreamableHttp` with your Vinkius endpoint. Simply pass the server instance into your `Agent` constructor to expose the tools.

Yes, every tool call is intercepted by your agent's defined guardrails. The agent validates the action, such as `delete_message`, against your safety logic before the request reaches Discord.

It relies on standard API requests, so it respects Discord's rate limits. Your agent handles the queuing and timing to ensure efficient operation without hitting throttle errors.

Your token is managed by Vinkius and injected at the transport layer. Your agent never sees the raw credential, keeping your credentials isolated from your agent's logic.

The agent only receives the specific output from tools like `list_messages` or `get_guild`. No private user data beyond what is returned by the Discord API is stored.

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