How to Use the Ably MCP in OpenAI Agents SDK

Q: Can Ably handle message history for my OpenAI Agents SDK agent?

Yes, you use the getmessages tool to pull historical data for any channel. It gives your agent the context needed to summarize recent events.

Q: Does Ably provide usage metrics for OpenAI Agents SDK agents?

Run the getstats tool to see exactly how your application is performing. It returns the raw usage numbers you need for monitoring.

Control real-time messaging directly from your OpenAI Agents SDK production system.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ably MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Push messages across channels with OpenAI Agents SDK

Your agent handles live data broadcast by triggering `batch_publish` or `publish_message` calls. It pushes updates to specific channels without manual intervention. This MCP Server allows your agent to manage notification traffic through `push_publish` and `batch_push_publish`. You get precise control over message delivery.

Track channel presence using OpenAI Agents SDK

Keep tabs on active users by calling `get_presence` or `get_presence_history`. Your agent pulls real-time snapshots of who is connected to specific channels. Automate your auditing by running `batch_presence` to check multiple endpoints at once. It keeps your agent aware of connection states in your production environment.

Manage channel lifecycle via OpenAI Agents SDK

Query your infrastructure status by running `list_channels` or `get_channel_metadata`. Your agent sees the pulse of your messaging layer in real-time. Audit your traffic patterns with `get_stats` to keep your system within limits. You can also clean up your environment by using `revoke_tokens` to invalidate keys.

Setup guide

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

Create your Agent

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

Run the agent

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

You initialize the connection using the MCPServerStreamableHttp class. Pass your server URL and add the instance to your Agent constructor to let it auto-discover the available tools.

Yes, you use the `get_messages` tool to pull historical data for any channel. It gives your agent the context needed to summarize recent events.

The server operates within a V8 Isolate sandbox, ensuring your operations remain isolated. You only need an endpoint token to manage your messaging keys securely.

Run the `get_stats` tool to see exactly how your application is performing. It returns the raw usage numbers you need for monitoring.

All communication is ephemeral and restricted by your specific API key permissions. The server only touches message payloads and presence metadata you explicitly authorize it to access.

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