# MailWizz MCP for AI Agents AI Agent Connect

> MailWizz connects your email marketing platform to your AI agent. It lets you manage subscriber lists, update contact data, and control campaign statuses through natural language. Whether you need to pause a live blast or find a specific list, this Connector handles the heavy lifting of interacting with the MailWizz REST API so you don't have to toggle between tabs.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zZceamGCzqZptHPMaGjhLxoFi7dzziC8mLzXU3El/ai-agent-connect
- **Tags:** email-campaigns, subscriber-management, self-hosted, audience-segmentation, campaign-management, list-management

## Description

MailWizz lets you put your email marketing on autopilot by letting your AI agent handle the nitty-gritty of audience management. Instead of logging into a dashboard to find a specific subscriber or manually pausing a campaign that's going off-track, you can just tell your agent what to do. It handles the communication with your self-hosted MailWizz instance, making it easy to sync data, update custom fields, and keep your lists clean. You'll find it's much faster to manage a large audience when your agent can instantly grab list details or add new signups to the right bucket. If you're looking for a way to keep your marketing data organized without the manual overhead, this Connector is a solid choice. It fits right into the Vinkius catalog, making it easy to plug into your existing workflow with Claude or Cursor. You get to stay focused on the strategy while the agent handles the data entry and campaign oversight.

## Tools

### delete_list_subscriber
Remove a person from a specific list. This helps maintain list hygiene and segment accuracy.

### get_campaign_details
Get the full metadata for a specific campaign. Use this to check delivery status and specific campaign IDs.

### list_list_subscribers
See every subscriber currently in a specific list. This is useful for auditing your audience size.

### list_subscriber_collections
View all your subscriber lists at once. Use this to navigate your different audience segments.

### update_list_subscriber
Change the information for a specific subscriber. This keeps your contact data current across your lists.

### list_email_campaigns
See a full list of your marketing campaigns. This helps you keep track of what's active and what's scheduled.

### get_list_details
Pull specific details for a subscriber list. Use this to find the correct UID before performing other actions.

### pause_email_campaign
Stop a live email campaign immediately. It's the quickest way to halt a blast if something goes wrong.

### add_subscriber_to_list
Put a new subscriber into the correct list. Use this to automate lead routing from your intake forms.

## Prompt Examples

**Prompt:** 
```
Pause the 'Summer Sale' campaign.
```

**Response:** 
```
I've paused the 'Summer Sale' campaign for you. The status is now set to paused in MailWizz. 

**Summary of Action:**
- **Campaign:** Summer Sale
- **Status:** Paused
- **Timestamp:** Just now
```

**Prompt:** 
```
Who is on my VIP list?
```

**Response:** 
```
Here are the subscribers currently in your VIP list:

| Name | Email | Status |
| :--- | :--- | :--- |
| Jane Doe | jane@example.com | Active |
| John Smith | smith@test.com | Active |

Would you like me to add anyone else to this list?
```

**Prompt:** 
```
Get the details for list 'New Leads'.
```

**Response:** 
```
I've retrieved the details for your 'New Leads' list:

- **List UID:** `lz987xyz`
- **Subscriber Count:** 450
- **Status:** Active

Let me know if you'd like to see the specific subscribers in this list.
```

## Capabilities

### Pause running email campaigns
Stop a live campaign immediately to prevent further sends.

### Add new subscribers to lists
Move new signups into the correct audience segments automatically.

### Update existing subscriber info
Modify contact details or custom fields for any person in your database.

### View all email campaigns
Get a full list of your marketing campaigns and their current status.

### Retrieve list details
Pull specific metadata and IDs for your various subscriber collections.

### Remove subscribers from lists
Take people off specific lists to keep your segments clean.

## Use Cases

### Emergency Campaign Halt
A manager sees a typo in a live blast and tells the agent to use pause_email_campaign immediately to stop the send.

### Bulk Contact Updates
A CRM specialist asks the agent to update contact info for a batch of users using update_list_subscriber to keep records fresh.

### Automated Lead Routing
A web form triggers a request to add a new user to a specific list using add_subscriber_to_list based on their interests.

### Subscriber List Auditing
A developer asks the agent to show all subscribers in a list using list_list_subscribers to check current volume and health.

## Benefits

- Stop live campaigns instantly by using pause_email_campaign when you spot a mistake in a blast.
- Keep your data clean by using update_list_subscriber to fix contact info on the fly without a dashboard.
- Build your audience faster by using add_subscriber_to_list to move leads into segments automatically.
- Get a bird's eye view of your marketing by using list_email_campaigns to check all active statuses.
- Simplify list management by using list_subscriber_collections to find the right UIDs quickly.
- Sync custom subscriber data fields automatically to keep your CRM and email lists in harmony.

## How It Works

The bottom line is you get to manage your entire email marketing audience through a simple chat interface.

1. Enter your MailWizz API URL and Public Key in your client settings.
2. Ask your agent to perform a task like pausing a campaign or adding a user.
3. The agent executes the request and confirms the update in your MailWizz account.

## Frequently Asked Questions

**Can the MailWizz MCP pause my active campaigns?**
Yes, it can. You can ask your agent to pause any live campaign immediately, which is helpful if you need to stop a mailing due to an error or a change in strategy.

**How do I use MailWizz MCP to manage my subscriber lists?**
You can use it to view your collections, find specific list IDs, and see who is on those lists without having to log into the MailWizz dashboard.

**Can I add new subscribers to lists using this Connector?**
Yes. You can tell your agent to add a new person to a specific list by providing their details, and the agent will handle the placement for you.

**Does the MailWizz MCP work with my self-hosted instance?**
Yes, it works with any self-hosted MailWizz instance as long as you provide your personal API URL and Public Key during setup.

**How does MailWizz MCP help with CRM data updates?**
It allows you to update existing subscriber information, such as contact details or custom fields, using simple natural language commands from your AI client.

**Can I see all my campaigns at once with MailWizz MCP?**
Yes, your agent can pull a full list of all your email marketing campaigns so you can check their statuses and metadata in one place.

**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.