How to Use the Listmonk MCP in OpenAI Agents SDK

Q: How can my python agents send transactional alerts using templates?

Your agent can call sendtransactionalmessage with the target email and template ID. It can query active templates first using listtemplates to ensure it uses the correct layout.

Manage your self-hosted newsletters directly inside your production OpenAI Agents SDK pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Listmonk MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated List Cleaning in OpenAI Agents SDK

This MCP Server exposes `list_bounces` to let your agents manage delivery failures directly. Connect this server to your run loop, and let specialized agents fetch delivery failures, analyze patterns, and permanently wipe dead emails using `delete_bounces`. The SDK's built-in guardrails ensure your agent doesn't wipe your entire subscriber list by mistake. You can trace every single database execution directly on your OpenAI developer dashboard, giving you complete visibility over automated list cleaning.

Safe Subscriber Updates via Agent Handoffs

This toolset uses `patch_subscriber` to modify subscriber preferences programmatically. When a subscriber wants to change their preferences, your front-facing agent can capture the raw text, parse the changes, and hand the task off to a specialized data agent. By using this MCP toolset, you avoid giving a single agent too much power. The secondary agent only has access to subscriber tools, while your primary agent handles user interaction, reducing the risk of unauthorized database modifications.

Programmatic Campaign Lifecycles

This toolset relies on `create_campaign` to let your Python agents draft and schedule newsletters. The agent uses campaign tools with your draft content, links a list via `list_lists`, and triggers the send phase using `update_campaign_status`. You can set cacheToolsList=True in the OpenAI Agents SDK config to cache these MCP schemas. This keeps your agent's system prompt small and fast, avoiding slow startup times during high-volume campaign operations.

Setup guide

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

Create your Agent

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

Run the agent

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

Install openai-agents first. Initialize MCPServerStreamableHttp pointing to your Vinkius endpoint, and then pass it into your Agent constructor using the mcp_servers list.

Yes, by using the SDK's built-in guardrail system to intercept agent calls. Your code can inspect the parameters for create_campaign before allowing the agent to execute the tool.

You should set cacheToolsList=True when configuring your streamable HTTP server. This prevents the SDK from pulling down the entire tool registry on every single agent run, which speeds up response times significantly.

Your agent can call send_transactional_message with the target email and template ID. It can query active templates first using list_templates to ensure it uses the correct layout.

Your subscriber emails and names are processed in memory within Vinkius's zero-trust V8 sandbox before hitting your database. No customer PII is ever cached by the proxy layer, keeping your raw subscriber tables secure.

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