How to Use the EmailOctopus MCP in AutoGen

Debate your email strategy by letting AutoGen agents negotiate using real-time EmailOctopus data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EmailOctopus MCP to AutoGen

Create your Vinkius account to connect EmailOctopus to AutoGen 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 EmailOctopus with AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Debate campaigns with AutoGen agents

One agent calls `get_campaign_performance_summary` while another analyzes the results. They debate whether the click-through rates justify a follow-up campaign. This deliberation removes bias from your decision-making. You get a consensus-driven recommendation based on actual performance metrics.

Multi-agent list management in AutoGen

Assign a security agent to check `list_list_contacts` for duplicates while a marketing agent optimizes the segments. They cross-reference the data to ensure high list quality. This collaborative approach automates tedious cleaning tasks. The agents negotiate the final list state before you approve any changes.

Performance auditing for AutoGen

The agents use `list_successfully_sent_campaigns` to build a timeline of activity. They challenge each other's assumptions about which content types drive the most engagement. You avoid vanity metric traps. The agents focus on the hard data retrieved from the server to keep your strategy on track.

Setup guide

Set up EmailOctopus MCP in AutoGen

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] package
Active Vinkius subscription with a valid endpoint token

1

Install AutoGen with MCP
Run pip install "autogen-ext[mcp]" autogen-agentchat. The MCP extension includes mcp_server_tools for stateless tool access.
2

Fetch tools from the MCP
Call mcp_server_tools(SseServerParams(url=...)) with your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Run your agent
Pass the tools to AssistantAgent and call agent.run(). The agent invokes EmailOctopus tools and returns structured results.

agent.py

from autogen_ext.tools.mcp import SseServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

tools = await mcp_server_tools(server_params)

agent = AssistantAgent(
    name="EmailOctopus_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent EmailOctopus data")
print(result.messages[-1].content)

Get your connection token →

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] + autogen-agentchat
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Same packages as above. McpWorkbench is ideal when your agent needs stateful sessions across multiple tool calls.
2

Use McpWorkbench as context manager
Wrap your agent in async with McpWorkbench(...) to maintain shared state and resources. The workbench manages the full MCP session lifecycle.
3

Run with workbench
Pass workbench=workbench to your agent. State is preserved across multiple tool calls within the same session.

agent.py

from autogen_ext.tools.mcp import McpWorkbench, SseServerParams
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

async with McpWorkbench(server_params) as workbench:
    agent = AssistantAgent(
        name="EmailOctopus_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent EmailOctopus data")
    print(result.messages[-1].content)

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 EmailOctopus. 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 EmailOctopus 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 EmailOctopus MCP in AutoGen

You provide the tool definitions to the assistant agent constructor. The adapter handles the schema conversion, enabling your agents to call the API tools during their discussion.

Yes, that is the point of the framework. Agents will debate the metrics returned by `get_campaign_details` until they reach a consensus on the campaign's next steps.

It does, supporting both stdio and HTTP transports. You plug it into your agent system and let the framework handle the tool execution flow.

Your credentials are used only to authorize the server. The agents never handle your API keys directly; they only receive the data returned by the tools.

The server implements strict read-only access for contact profiles. Data is encrypted in transit and exists only as temporary context for the agents to perform their assigned task.

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