Manage your entire email audience from natural prompts. 
Claude 
ChatGPT 
Cursor 
Gemini 
Windsurf 
VS Code 
JetBrains 
Vercel
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
MailWizz MCP Server connects your AI agent directly to your email marketing platform's API. It lets you manage subscriber lists, track campaign statuses, and update user records—all from natural language prompts in your IDE or client.
You don't need to open the web dashboard; just tell your agent what needs doing.
What your AI can do
Add subscriber to list
Adds a new user to a specific list, requiring the list's UID and the subscriber's data fields.
List email campaigns
Returns an array of all email marketing campaigns managed in your MailWizz account.
Delete list subscriber
Removes an existing subscriber from a specified list using their unique identifiers.
List all email marketing campaigns, or retrieve detailed metadata for a single campaign using get_campaign_details.
Pause or unpause an active mail campaign programmatically via the pause_email_campaign tool.
Get a full list of all subscriber collections (list_subscriber_collections) or retrieve every member currently in a specific list using list_list_subscribers.
Add new subscribers to lists with add_subscriber_to_list, remove existing users with delete_list_subscriber, or modify contact data using update_list_subscriber.
Retrieve detailed information about a specific subscriber list, including its unique identifier and structure, via get_list_details.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
MailWizz MCP Server: 9 Tools for Email Marketing
These nine tools let your agent perform every core task in email marketing—from listing all collections to updating individual subscriber profiles.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using MailWizz on VinkiusAdd Subscriber To List
Adds a new user to a specific list, requiring the list's UID and the subscriber's data fields.
List Email Campaigns
Returns an array of all email marketing campaigns managed in your MailWizz account.
Delete List Subscriber
Removes an existing subscriber from a specified list using their unique identifiers.
Get Campaign Details
Retrieves detailed metadata and status information for one specific email marketing...
Get List Details
Gets comprehensive details about a particular subscriber list, including its...
List List Subscribers
Lists every subscriber currently contained within a specified list collection.
List Subscriber Collections
Retrieves the names and IDs for all subscriber lists (collections) in your account.
Pause Email Campaign
Stops a running email campaign immediately, suspending its automated delivery...
Update List Subscriber
Modifies the contact details of an existing subscriber within any defined list.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The MailWizz integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with MailWizz, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 9 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Managing email lists means constantly opening web dashboards.
Today, managing a simple subscriber list change involves logging into MailWizz, navigating to the collection, finding the specific user, and manually updating their status or adding them to another group. If you need to audit 50 users across 3 different lists, that's at least 15 minutes of clicking through tabs just to copy names.
With this MCP server, your agent handles it all in one prompt. You tell it: 'Move these five people from List A to List B and update their last-contact date.' The agent runs the necessary `delete_list_subscriber` calls followed by `add_subscriber_to_list`, returning a clean confirmation right where you are working.
MailWizz MCP Server: Control Campaigns
Manually monitoring campaign status means checking the dashboard, looking for 'Sending' tags, and guessing if it has hit its send limit. If you need to stop a runaway mailing immediately, you have to find the exact UID first.
Now, your agent runs `list_email_campaigns` to see all options, then uses `get_campaign_details` to confirm status. The punchline? You tell it 'Pause Campaign XYZ,' and the server executes `pause_email_campaign` instantly. No UI navigation required.
What your AI can actually do with this
Listen up. This MCP Server connects your AI agent right into MailWizz's API. It lets you manage your entire email marketing operation—your lists, your campaigns, your subscribers—all through natural language prompts in your IDE or client. You don't gotta open the web dashboard; you just tell your agent what needs doing.
Managing Campaigns:
You can see every campaign running by invoking list_email_campaigns, which returns an array of all campaigns managed in your account. If you wanna dig deep on a single send, use get_campaign_details. It pulls detailed metadata and the current status for one specific email marketing campaign. When a campaign's delivery needs to stop immediately, you can programmatically pause it using pause_email_campaign, which suspends its automated sending process.
Handling Subscriber Lists:
To see what collections of people you got, run list_subscriber_collections. That gives you the names and IDs for every subscriber list in your account. If you need to know the structural details—like what fields it expects or its unique ID—use get_list_details on a specific collection. To get a full roster of who's actually signed up, run list_list_subscribers, specifying which list you want to check.
This action returns every single subscriber currently inside that chosen list.
Modifying Users and Contacts:
You can manage the actual people in your lists from the command line. If a user signs up, use add_subscriber_to_list; you gotta pass it both the list's UID and all of the subscriber's required data fields for that addition to stick. When someone leaves or messes up their info, you can clean things up with delete_list_subscriber, which removes an existing user using their unique identifiers.
If a contact updates their phone number or email but stays on the list, use update_list_subscriber to modify that person's details within any defined list.
This whole setup gives your agent full control over the lifecycle of your mailing lists and sends. You tell it to add users, delete them, update them, pull campaign status checks, or get a complete dump of who's signed up in every collection. It's all about making sure your AI client handles the complexity behind the scenes so you don't gotta touch another dashboard.
019d75cd-835b-71b9-85cb-667264433c33 
Here's how it actually works
The bottom line is that your AI client sends commands to this server, which translates those commands into specific API calls for MailWizz, returning clean data every time.
First, subscribe to the server and provide your MailWizz API URL along with your Public Key.
Your AI client establishes a secure connection to the endpoint. This allows it to execute specific operations (e.g., listing campaigns or adding subscribers) on your behalf.
You simply prompt your agent: 'List all active email campaigns.' The agent uses list_email_campaigns, gets the JSON result, and presents it back to you.
Who is this actually for?
This is for the digital marketing ops engineer who's sick of jumping between dashboards and spreadsheets. If you manage email lists or run campaigns daily, this server lets your AI client handle the API calls without you ever leaving your primary coding environment.
Runs monthly audits to ensure subscriber data is clean; uses list_list_subscribers and update_list_subscriber to fix list health.
Integrates MailWizz logic into custom internal tools, using the server to automate user sign-ups via add_subscriber_to_list.
Checks campaign status and modifies sends quickly; uses list_email_campaigns and pause_email_campaign when needed.
What Changes When You Connect
Control sends instantly. Need to hit pause on a campaign? Use pause_email_campaign rather than logging into the web panel and clicking through menus. It’s fast, direct action.
Full subscriber visibility. You can list every collection with list_subscriber_collections, then drill down using get_list_details to understand the segment structure for targeted outreach.
Keep your data current. Instead of manual CSV uploads, use add_subscriber_to_list or update_list_subscriber to write clean API calls that sync contact records with zero risk of format errors.
Audit list health on demand. Running list_list_subscribers gives you a real-time dump of who's in the list, letting your agent quickly check for stale or incomplete records.
See campaign status at a glance. Use list_email_campaigns to get an immediate overview of all active and archived campaigns without opening the platform’s dashboard.
See it in action
Need to reactivate users from old lists.
The marketing team found a list of high-value, dormant contacts. They ask their agent to 'Get all users in the 'VIP Leads' list and update their status.' The agent runs list_list_subscribers first for validation, then executes update_list_subscriber for each user, ensuring they are marked as active before sending a re-engagement flow.
A new sign-up needs to be added and tracked.
An external system generates a list of new leads. Instead of exporting them, the developer prompts the agent: 'Add these 5 users to the 'Main Leads' list.' The agent uses add_subscriber_to_list five times sequentially, confirming successful ingestion for every user.
The current campaign is failing and needs a manual stop.
During peak hours, an email campaign starts sending bad content. The manager prompts: 'Pause the Q2 product update campaign.' The agent immediately executes pause_email_campaign using the campaign's UID, stopping all further sends within seconds.
Comparing two different audience segments.
The CRM team wants to compare who is on the 'Beta Testers' list versus the 'Early Adopters' list. They prompt the agent to run list_list_subscribers for both UIDs. The agent returns two distinct, structured lists of IDs, allowing for side-by-side comparison.
The honest tradeoffs
Assuming data consistency.
Trying to run update_list_subscriber on a user ID that might have been deleted or moved. This will fail, and the agent just reports an error without context.
Before updating, always check list membership first. Use get_list_details or list_list_subscribers to confirm the target subscriber's existence and their current associated list UID. That way, you can validate the input before running update_list_subscriber.
Bulk operations without listing first.
Trying to delete 100 users by guessing IDs or writing a massive script that assumes all UIDs are correct. This is slow, error-prone, and hits rate limits quickly.
First, run list_list_subscribers for the target list collection. Use the resulting array of valid subscriber UIDs to feed into your agent prompt. Then, execute a loop using delete_list_subscriber on the confirmed IDs.
Ignoring campaign status.
Attempting to run a welcome sequence when the main mailing list is already paused or archived. The action fails because the underlying MailWizz API call doesn't know about your intended state change.
Always start by running list_email_campaigns and check the status metadata returned by get_campaign_details. If it isn't 'active,' you should run pause_email_campaign (if necessary) or skip the action entirely.
When It Fits, When It Doesn't
Use this server if your core problem is basic CRUD operations on subscriber records and campaign management. This means: adding users, removing users, changing fields (name/email), pausing sends, or listing contents.
Don't use it if you need advanced behavioral triggers. For instance, if the rule is 'If a user opens Email X but doesn't click Y within 48 hours, then move them to List Z,' this server won't handle that logic flow. You'd need an external automation layer (like Zapier or a custom webhook) that listens for behavioral events and then calls the update_list_subscriber tool.
It works best when your AI client acts as the orchestrator: 1. Read data (list_email_campaigns). 2. Decide action based on data (e.g., 'Campaign X is outdated'). 3. Execute action (pause_email_campaign).
Questions you might have
How do I find all my subscriber lists using MailWizz MCP Server? +
You run the list_subscriber_collections tool. This returns a complete list of every collection you have, along with their unique IDs (UIDs), which you'll need for further actions.
Can I update multiple users at once using MailWizz MCP Server? +
The server handles individual updates. You first use list_list_subscribers to get all target IDs, and then your agent can loop through those IDs, running the update_list_subscriber tool for each one.
What if I want to know the details of a specific campaign? +
Use get_campaign_details. You just need to provide the campaign's UID. It returns all metadata, including status, send date range, and more.
Does MailWizz MCP Server support bulk deletion of subscribers? +
Yes. The process is: run list_list_subscribers to get IDs; then use the array of IDs with the delete_list_subscriber tool.
How do I set up the connection credentials for `MailWizz` MCP Server? +
You connect by providing your MailWizz API URL and a Public Key. These details authenticate your AI agent against your self-hosted instance, ensuring secure access to your marketing data.
What happens if I use `update_list_subscriber` with an invalid subscriber UID? +
The operation will fail and return a specific error code. Your AI client catches this failure, telling you exactly which record needs correction before retrying the update.
Are there rate limits when I frequently call `list_email_campaigns`? +
Yes, like all API integrations, MailWizz enforces standard rate limits. Always check your account dashboard to know the specific throughput restrictions for reliable operation.
Can I use `MailWizz` MCP Server to delete campaign data entirely? +
No; this server focuses on audience and campaign management, not deletion of historical records. You must access MailWizz's core platform tools for permanent data removal.
How do I find my List UID or Campaign UID? +
You can retrieve all UIDs by using the list_subscriber_collections or list_email_campaigns tools. They are also visible in the URL when viewing these resources in your MailWizz dashboard.
Can I add custom fields when subscribing a user? +
Yes, include your custom field values (like FNAME, LNAME) within the subscriber_json object when using the add_subscriber_to_list tool.
What is the API URL? +
This is the full base URL where your MailWizz API is reachable, for example: https://mail.yourdomain.com/api. Your token is encrypted at rest and injected securely at runtime.
We've already built the connector for MailWizz. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 9 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.