How to Use the MailWizz MCP in LangChain

Q: How do I connect the MailWizz MCP Server to my LangChain agent?

Install langchain-mcp-adapters and initialize the MultiServerMCPClient with the Vinkius endpoint URL. Pass the retrieved tools directly to your agent executor to start managing lists.

Q: Can LangChain run multi-step campaigns using MailWizz tools?

Yes, your agent can chain tools together by using getlistdetails to verify a list exists before calling addsubscribertolist to register a new user. Every step is logged in LangSmith for debugging.

Connect your LangChain chains directly to MailWizz to run automated subscriber updates and campaign audits.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MailWizz MCP to LangChain

Create your Vinkius account to connect MailWizz to LangChain 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 MailWizz with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Subscriber Updates in LangChain

The `add_subscriber_to_list` MCP tool lets your LangChain agent insert new contacts into your marketing database during any active chain. If a user signs up via a connected database, the agent triggers this tool, captures the subscriber UID, and passes it to the next step without manual coding. You can also use `update_list_subscriber` to modify existing records on the fly. LangSmith tracks every step of this data flow, showing you exact execution times and payload sizes so you can spot bottlenecks instantly.

Run Automated Campaign Audits

The `list_email_campaigns` tool pulls your entire campaign history directly into your agent's context. Your agent analyzes past performance metrics, then uses `get_campaign_details` to drill down into specific subject lines or send times that drove high engagement. If a campaign goes off the rails or requires immediate intervention, the agent invokes `pause_email_campaign` to stop the send. This creates a closed-loop reasoning chain where your agent monitors and reacts to real-time marketing metrics.

Sync Lists Across External Databases

Using `list_subscriber_collections` lets your agent map out all available subscriber lists inside your MailWizz setup. The agent matches these lists with external SQL databases or CRM platforms using LangChain's extensive integration library. To keep your contacts clean, the agent calls `list_list_subscribers` to fetch current records and runs a diff against your internal systems. Any mismatches are resolved instantly by running `delete_list_subscriber` to remove opt-outs or dead addresses.

Setup guide

Set up MailWizz MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes MailWizz tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "mailwizz-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent MailWizz transactions"
    })
    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 MailWizz. 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 MailWizz 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 MailWizz MCP in LangChain

Install `langchain-mcp-adapters` and initialize the `MultiServerMCPClient` with the Vinkius endpoint URL. Pass the retrieved tools directly to your agent executor to start managing lists.

Yes, your agent can chain tools together by using `get_list_details` to verify a list exists before calling `add_subscriber_to_list` to register a new user. Every step is logged in LangSmith for debugging.

The framework relies on standard client-side backoff strategies when executing tools like `list_email_campaigns` in rapid succession. You can configure custom retry logic within your chain definition.

Absolutely, you can combine this server with SQL database tools or vector stores in a single LangGraph state machine. This lets your agent query local user data and write it to MailWizz in one run.

Vinkius runs this MCP Server inside an ephemeral V8 sandbox, ensuring your subscriber email addresses and list details are never stored or logged on our infrastructure. All API communication travels over encrypted HTTPS directly to your self-hosted instance.

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