How to Use the Emma MCP in OpenAI Agents SDK

Q: How do I connect the Emma MCP Server to the OpenAI Agents SDK?

Install the openai-agents package first. Create an MCPServerStreamableHttp instance with your endpoint URL, then pass it to the agent constructor. Set cacheToolsList=True to speed up tool discovery.

Q: What happens if the agent tries to delete a group?

The deletegroup tool only removes the organizational bucket. Members inside that group stay on your main subscriber list. You never lose actual contacts when cleaning up old campaign segments.

Q: How do I track specific email metrics with Emma in OpenAI Agents SDK?

Call getmailingstats with the specific mailing ID. Your agent receives the exact response numbers, including opens and clicks. The SDK's tracing dashboard lets you see exactly when the agent requested this data.

Q: Does this setup expose my subscriber email addresses?

Tools like getmember and listmembers handle personally identifiable information like email addresses and names. Vinkius runs this MCP Server in a zero-trust V8 Isolate Sandbox. The container is ephemeral and dies immediately after the request finishes, leaving zero residual data behind.

Connect the Emma MCP Server to the OpenAI Agents SDK to manage email campaigns and subscriber lists automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Emma MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage subscribers with OpenAI Agents SDK

The Emma MCP Server uses `list_members` to let your OpenAI agent pull active audiences into context. You just call the endpoint to read the current subscriber state. From there, the agent checks custom attributes using `list_fields` to see exactly how your marketing segments are built. Guardrails matter when you touch production data. Because this SDK supports built-in validation, your agent avoids blindly firing off requests. It grabs specific profiles via `get_member` and verifies the target before making any moves.

Automate group operations

Your agent handles list segmentation through the `create_group` and `list_groups` tools. Instead of manual exports, the system automatically spins up new target buckets based on user behavior. It pulls the current group structure and builds exactly what is missing. Heads-up on deleting segments. Running `delete_group` removes the bucket without dropping the actual members inside it. You keep your subscriber count intact while cleaning up stale campaign infrastructure.

Track campaign performance

By hitting `list_mailings` and `list_automations`, your setup sees exactly what went out and what is scheduled. Agents need feedback loops to optimize marketing workflows. It maps the entire outbound pipeline directly into the OpenAI tracing dashboard. Raw numbers dictate the next move. The `get_mailing_stats` endpoint feeds open and click rates straight into your agent's reasoning engine. You can even check `list_webhooks` to ensure your asynchronous tracking events are firing correctly.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the `openai-agents` package first. Create an `MCPServerStreamableHttp` instance with your endpoint URL, then pass it to the agent constructor. Set `cacheToolsList=True` to speed up tool discovery.

Yes. You can build a specialized marketing agent that just handles Emma API calls. Once it finishes pulling campaign data, it hands the payload off to a separate analytics agent for processing.

The `delete_group` tool only removes the organizational bucket. Members inside that group stay on your main subscriber list. You never lose actual contacts when cleaning up old campaign segments.

Call `get_mailing_stats` with the specific mailing ID. Your agent receives the exact response numbers, including opens and clicks. The SDK's tracing dashboard lets you see exactly when the agent requested this data.

Tools like `get_member` and `list_members` handle personally identifiable information like email addresses and names. Vinkius runs this MCP Server in a zero-trust V8 Isolate Sandbox. The container is ephemeral and dies immediately after the request finishes, leaving zero residual data behind.

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