How to Use the Acelle Mail MCP in OpenAI Agents SDK

Build production-ready marketing agents for Acelle Mail using the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Acelle Mail MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Lists with Guardrails

Build an agent that manages your Acelle Mail lists without the risk of it going off the rails. The OpenAI Agents SDK provides guardrails that your agent must follow, so it can't accidentally email the wrong list or add subscribers without permission. You define the rules, the agent executes safely. Your agent gets access to tools like `add_acelle_subscriber` and `create_acelle_list`, but its actions are constrained by your logic. This is perfect for building internal tools that let non-technical teams request new email segments without needing direct access to Acelle Mail. The agent handles it, and you get a full trace in your OpenAI dashboard.

Automate Campaign Reporting

Stop manually pulling numbers from your email platform. You can build an agent that periodically checks campaign performance and delivers reports right to your team. It's a simple, reliable way to keep everyone in the loop on what's working. Give your agent a schedule and have it call `list_acelle_campaigns` and `get_acelle_campaign` to fetch the latest open rates, click-throughs, and other key metrics. Because it's using an MCP Server, the connection is handled for you. The agent can then format this data and send it to Slack or an internal dashboard.

Debug Agent Actions with Full Tracing

When an agent does something unexpected, you need to know why. The OpenAI Agents SDK automatically traces every tool call, decision, and error. If your agent fails to create a new subscriber list in Acelle Mail, you'll see the exact `create_acelle_list` call and the response from the server. This isn't just for errors. Tracing gives you a clear picture of your agent's reasoning. You can see how it interpreted a request, which tools it decided to use, and what data it passed. It makes optimizing and debugging your marketing automation agents much faster.

Setup guide

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

Create your Agent

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

Run the agent

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

First, pip install openai-agents. Then, instantiate the MCP server connection in your Python code and pass it to your Agent constructor. The agent will automatically discover all the available Acelle Mail tools like `list_acelle_campaigns`.

Yes. While the MCP Server exposes all seven Acelle Mail tools, you can implement guardrails within your OpenAI Agent's code. This lets you restrict it to read-only operations or only allow it to add subscribers, for example.

Absolutely. This MCP server works with any model compatible with the OpenAI Agents SDK, including GPT-4, GPT-4 Turbo, and GPT-3.5. The tools behave the same regardless of the underlying model you choose.

Yes. You can create multiple MCPServerStreamableHttp instances, one for each Acelle Mail server you want to manage. Pass them as a list to the Agent constructor, and your agent will be able to distinguish between them and target the correct one.

The MCP server only processes subscriber data like emails and names, plus campaign content, and it doesn't store anything. Your connection is ephemeral and secured by your Vinkius token. The OpenAI SDK's tracing also gives you a full audit log of every action your agent takes on your Acelle Mail data.

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