How to Use the MoonMail MCP in OpenAI Agents SDK

Q: Can I run agent handoffs with this setup?

Yes, you can. You can have one agent use listlists to find the correct target audience, then hand off the execution to a sending agent that runs sendcampaign.

Q: How do I trace MoonMail tool execution logs in OpenAI Agents SDK?

Every time your agent calls listcampaigns or getcampaignstats, the call is logged in your OpenAI dashboard. This MCP connection gives you full visibility into what data your agent read and when.

Build production OpenAI Agents SDK systems that safely trigger MoonMail campaigns and manage subscriber lists.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MoonMail MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate subscriber signups with safety guardrails

The `add_subscriber` tool lets your agent drop new emails directly into your lists. Since you are building with the OpenAI Agents SDK, you can set strict validation guards to ensure your agent never adds malformed addresses or duplicates. This prevents bad email data from corrupting your MoonMail lists. You get clean, immediate subscriber updates without writing custom verification code in your OpenAI Agents SDK pipeline.

Run campaigns safely using OpenAI Agents SDK handoffs

Drafting email sends starts with the `create_campaign` tool, which prepares your content. When using the OpenAI Agents SDK, you can delegate draft creation to a junior agent and restrict the `send_campaign` call to a supervised manager agent. This multi-agent setup keeps your MoonMail account safe. The OpenAI Agents SDK dashboard tracks every single tool call, so you always know which agent triggered the send.

Track performance metrics via the MCP Server

Pulling open rates, clicks, and bounce metrics is handled by the `get_campaign_stats` tool directly inside your agent's context. Your OpenAI Agents SDK pipeline can read these numbers to decide if a campaign needs a follow-up email. You can also query raw interaction logs using `get_events`. This lets your OpenAI Agents SDK system run post-campaign analysis and adjust its copy for the next MoonMail run.

Setup guide

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

Create your Agent

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

Run the agent

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

The MCP Server handles rate limits by queuing requests automatically. If your OpenAI Agents SDK system triggers multiple `send_campaign` calls, the server manages the pacing to avoid API errors.

Yes, you can. You can have one agent use `list_lists` to find the correct target audience, then hand off the execution to a sending agent that runs `send_campaign`.

No, the schema is auto-discovered. The OpenAI Agents SDK reads the MoonMail tool metadata directly through the MCP protocol, meaning your agent instantly knows how to format inputs for `add_subscriber` without manual configuration.

Every time your agent calls `list_campaigns` or `get_campaign_stats`, the call is logged in your OpenAI dashboard. This MCP connection gives you full visibility into what data your agent read and when.

Your subscriber email addresses and list details remain securely inside MoonMail. This connection uses Vinkius's zero-trust sandbox to run the MCP Server, meaning your OpenAI Agents SDK calls are ephemeral and no raw contact data is stored outside your designated accounts.

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