How to Use the Iterable MCP in AutoGen

Q: How do I register the Iterable MCP server tools with an AutoGen agent?

You use the mcpservertools helper with your secure Vinkius URL. This automatically registers tools like listcampaigns and getuser as executable functions for your AssistantAgent.

Q: Do these tools support writing or updating campaigns?

No, this server provides read-only tools like listlists and listworkflows. Your agents can analyze, debate, and recommend changes, but they cannot accidentally delete or modify your production marketing assets.

Q: Is my subscriber list data safe during multi-agent conversations?

Yes, when agents query subscriber segments using listlists, all data transfers occur over encrypted channels. The Vinkius platform uses zero-trust ephemeral runtimes, meaning your subscriber lists and campaign configurations are never stored or logged.

Let AutoGen agents debate and optimize your Iterable campaigns using live performance metrics and workflow data via MCP.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Iterable MCP to AutoGen

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Enable consensus-driven campaign optimization

Set up an AutoGen conversation where a marketing agent and an analyst agent debate campaign performance. The analyst pulls live data using `get_campaign_metrics`, while the marketer reviews the setup with `get_campaign`. They negotiate the next steps based on real numbers. By comparing active campaigns from `list_campaigns` with target audiences, they agree on which templates need immediate updates.

Audit automation logic via AutoGen MCP Server tools

Your agents can collaborate to check for gaps in your user journeys. One agent reviews active triggers with `list_workflows` while another inspects the delivery paths using `list_channels`. This multi-agent audit ensures your automated messaging makes sense. They cross-reference their findings with configured destinations in `list_webhooks` to verify that external systems are receiving data correctly.

Align template designs with active message types

Let your agents coordinate content updates across different communication channels. An agent can list your active layout styles using `list_templates` while another checks the categories using `list_message_types`. They work together to flag inconsistent branding or outdated copy. Instead of a single model guessing, the agents verify the layout structure against live channel constraints before recommending changes.

Setup guide

Set up Iterable 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 Iterable 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="Iterable_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent Iterable 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="Iterable_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent Iterable 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 Iterable. 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 Iterable 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 Iterable MCP in AutoGen

You use the mcp_server_tools helper with your secure Vinkius URL. This automatically registers tools like `list_campaigns` and `get_user` as executable functions for your AssistantAgent.

Yes, the tools are passed to the agent group chat environment. Both your analyst agent checking `get_campaign_metrics` and your designer agent checking `list_templates` can call tools in the same conversation.

The McpToolAdapter handles schema conversion and returns standard error payloads. If an agent tries to call `get_campaign` with an invalid ID, the error is returned to the chat, allowing the agents to debate and correct the ID.

No, this server provides read-only tools like `list_lists` and `list_workflows`. Your agents can analyze, debate, and recommend changes, but they cannot accidentally delete or modify your production marketing assets.

Yes, when agents query subscriber segments using `list_lists`, all data transfers occur over encrypted channels. The Vinkius platform uses zero-trust ephemeral runtimes, meaning your subscriber lists and campaign configurations are never stored or logged.

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