How to Use the Mailsoftly MCP in OpenAI Agents SDK

Q: Will Mailsoftly work with specialized agent handoffs in the OpenAI Agents SDK?

It works perfectly. You can restrict the sendcampaigntoall tool to a specific deployment agent, keeping your lower-level data-entry agents safely isolated from the send button.

Build production-ready email agents with OpenAI Agents SDK. Manage subscriber lists and trigger campaigns via this MCP Server safely.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailsoftly MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe campaign execution via Mailsoftly MCP Server

Your agent needs strict boundaries before it blasts out a newsletter. By connecting this tool, you give your OpenAI agent direct access to `send_campaign_to_all`. But because you are using this SDK, you can wrap that action in built-in guardrails. The agent checks the audience parameters, runs validation, and waits for a human-in-the-loop approval before anything actually goes out. You also get full execution tracing in the OpenAI dashboard. If an agent runs `list_marketing_campaigns` and decides to trigger a send, you see the exact decision tree. It prevents rogue scripts from spamming your entire database at 3 AM.

Build specialized contact routing agents

Handoffs make multi-agent systems work. You can build one specialized agent that reads inbound customer support tickets and extracts email addresses. That agent then hands the data off to a marketing agent equipped with the `create_base_contact` tool. Once the contact exists in the database, the agent calls `add_contact_to_list` to drop them into a highly specific segment. You stop relying on Zapier delays. The routing happens instantly in code, and you track the whole flow through the SDK's native logging.

Read engagement data for automated follow-ups

Running blind campaigns wastes money. Your agent can pull post-send metrics using `get_campaign_click_data` and `list_sent_history`. It looks at who clicked what, analyzes the engagement drop-off, and drafts follow-up sequences based on actual user behavior. The agent does not just guess what worked. It pulls hard metrics from the REST API and feeds them back into your prompt context. You get automated campaign post-mortems delivered straight to your Slack channel.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the openai-agents package via pip. Create an MCPServerStreamableHttp instance with your Vinkius endpoint URL and pass it into your agent's mcp_servers array. Set cacheToolsList=True to speed up initialization.

Yes. The SDK auto-discovers every tool on the MCP server. Your agent can call `list_subscriber_collections` without you writing any custom parsing logic.

It works perfectly. You can restrict the `send_campaign_to_all` tool to a specific deployment agent, keeping your lower-level data-entry agents safely isolated from the send button.

You configure guardrails in the SDK. Before the agent executes the final send, it must pass your validation checks. You retain total control over the trigger.

The server runs in a V8 Isolate Sandbox. When your agent pulls email addresses or click data, the transaction happens in memory and vanishes immediately. We log zero payload data, meaning your subscriber lists never touch our disks.

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