# Mailingwork MCP

> Mailingwork executes professional email marketing campaigns using your AI client. It handles advanced audience segmentation, A/B testing, and list management while keeping GDPR compliance top-of-mind. You manage every aspect of your mailing program—from creating subscribers to analyzing click maps—all through natural conversation with your agent.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** gdpr-compliant, campaign-management, subscriber-segmentation, ab-testing, email-analytics, list-management

## Description

You connect your AI client to Mailingwork for professional email marketing campaigns. You manage everything—from building out segments to running deep analytics—all without ever leaving your chat window.

***

**Managing Your Audience Lists**
You don't have to build lists manually; you can tell your agent to handle the heavy lifting of subscriber data. Use `create_subscriber` to add a brand-new contact right away. Need details on one person? Just ask, and it runs `get_subscriber` to pull all their specific data. If you need to modify someone's info—like changing their status or updating a field—you run `update_subscriber`. To see who you’re dealing with, your agent can fetch multiple subscribers using `list_subscribers` based on filters you give it.

For segmenting people, the system knows all its segments. You can get a full list of every available mailing segment by calling `list_lists`, and if you need to filter that further, `list_tags` shows you all the existing segmentation tags you've set up. This whole process keeps compliance front-of-mind; your agent confirms GDPR consent settings for any group you target.

**Running Campaigns and Checking Performance**
*Mailingwork executes campaigns through multiple tools.* You can review what’s happened historically by calling `list_mailings`, which shows a summary of all past or scheduled campaigns. To get deep performance metrics on a specific job, run `get_mailing` to pull detailed data for that campaign. This doesn't just give you open rates; it gives you full analytics like click maps and delivery stats so you know exactly how well the emails landed.

**Sending Targeted Emails and Automating Actions**
Sometimes you don’t need a big campaign. You might only need to send one off email, like an order confirmation or a password reset—for that, use `send_transactional_email`. For complex actions, your agent triggers automated workflows using `trigger_automation`, starting any pre-built process within Mailingwork when certain events happen.

**What You Can Do with This Server:**
* **Segmenting People:** You can tell the system to pull lists of subscribers by checking all available tags or listing every segment you've created. *You get a full picture of who owns the list.* 
* **Tracking Campaigns:** You can review summaries of past campaigns via `list_mailings` and then dive deep into performance reports using `get_mailing` to check open rates or click maps.
* **Fixing Data:** If someone's details are wrong, you run `update_subscriber`. Need a new contact? Run `create_subscriber`. 
* **Action Items:** You can send immediate transactional emails with `send_transactional_email`, and even start automated processes using `trigger_automation`.

## Tools

### create_subscriber
Adds a new contact to your mailing list.

### get_mailing
Retrieves detailed information about a specific campaign or mailing.

### get_subscriber
Pulls all data for one specified subscriber ID.

### list_lists
Shows you every segment list available in your account.

### list_mailings
Lists all past and scheduled campaigns/mailings.

### list_subscribers
Fetches a list of multiple subscribers based on provided filters.

### list_tags
Returns all existing segmentation tags you can use to filter lists.

### send_transactional_email
Sends an email for a specific action, like sending a user's order confirmation.

### trigger_automation
Starts a pre-built workflow or automated process within Mailingwork.

### update_subscriber
Changes details for an existing subscriber, like updating their name or status.

## Prompt Examples

**Prompt:** 
```
Show all campaigns and performance for this month.
```

**Response:** 
```
Campaigns (April): 6 sent. 'Spring Newsletter' (3,200 recipients, 38% open, 8% click ⭐). 'Product Update' (2,800, 32% open, 6%). 'Webinar Invite' (1,500, 45% open ⭐, 12% click). 3 others. Total sent: 12,400. Avg open: 35%. Avg click: 7.2%. Bounces: 1.1%. Unsubscribes: 0.3%.
```

**Prompt:** 
```
Show mailing lists and subscriber growth.
```

**Response:** 
```
Lists: 4. 'Main Newsletter' (3,200 subscribers). 'Product Updates' (2,800). 'Webinar Attendees' (890). 'Partner Newsletter' (450). Total: 7,340. Growth (30 days): +180 new, -25 unsubscribes. GDPR consent: 100% confirmed. Double opt-in: enabled.
```

**Prompt:** 
```
Show click map and deliverability report for the Spring Newsletter.
```

**Response:** 
```
Spring Newsletter click map: 'Shop Now' button (142 clicks, 55%). 'Read More' link (68, 26%). 'Social links' (34, 13%). 'Unsubscribe' (15, 6%). Deliverability: Delivered: 3,168 (99%). Soft bounce: 22 (0.7%). Hard bounce: 10 (0.3%). Spam: 2 (0.06%). Inbox placement: 96% (estimated).
```

## Capabilities

### Manage subscriber lists
Create new contacts, retrieve details on specific subscribers, and list all available mailing segments.

### Run campaigns and get metrics
List past mailings or campaign summaries, and pull deep analytics like open rates and click map data for performance reviews.

### Send targeted emails
Dispatch one-off transactional emails (e.g., password resets) or trigger complex automated workflows based on user actions.

### Update audience data
Modify existing subscriber records, updating fields like status or preferences without touching the main list structure.

### Check compliance and tags
List all available segmentation tags and confirm GDPR consent settings for any segment you are targeting.

## Use Cases

### The quarterly review.
A manager needs to prove ROI. They ask the agent: 'Show me total recipients and average click rate for Q1.' The agent calls `list_mailings` and synthesizes the data, providing a single summary report showing 35% average open rates across all campaigns.

### Onboarding new clients.
An account manager has 20 new leads. Instead of manually adding them one by one, they use `list_subscribers` with a bulk filter and then call `create_subscriber` for the entire group, making sure all accounts are instantly active.

### Fixing an inactive segment.
A campaign is failing because some users opted out. The user asks to 'find everyone who unsubscribed last week.' The agent uses `list_subscribers` with a date range and then confirms the status by calling `get_subscriber` on a few test accounts.

### Handling an order update.
A user just placed an order. Instead of sending it through a separate platform, the agent is prompted to 'Send the final receipt for Order #456.' The tool calls `send_transactional_email`, completing the communication loop instantly.

## Benefits

- You get real-time performance data. Instead of logging into the analytics dashboard, you ask your agent to 'Show all campaigns and performance for this month,' getting immediate metrics on open rates and clicks from `list_mailings` results.
- Compliance is built in. You can confirm GDPR consent status or list available tags using `list_tags`, ensuring that any segment you target has the necessary user permissions before running a campaign.
- You save time on data retrieval. Need to know if a specific contact exists and what their preferences are? Use `get_subscriber` instead of hunting through massive export files, getting clean data points instantly.
- Automation is immediate. If a user hits a key milestone (like signing up), you don't have to manually send an email; you just call `trigger_automation`, letting the system handle the rest.
- You control every message flow. Beyond newsletters, use `send_transactional_email` for critical one-off messages—think password resets or order confirmations—ensuring brand consistency across all communications.

## How It Works

The bottom line is: You talk about marketing tasks, and the server performs the necessary actions using specific Mailingwork tools.

1. Subscribe to the server and provide your Mailingwork credentials.
2. Your AI client accesses the dedicated tools, allowing you to reference specific list IDs or campaign names in conversation.
3. The agent executes the tool call (e.g., `list_mailings`) and returns structured data that your client can interpret directly.

## Frequently Asked Questions

**How do I check campaign performance using Mailingwork MCP Server?**
Call `list_mailings` to get a list of all campaigns. Then, ask for the metrics on a specific ID or name. The agent pulls open rates and click data directly.

**Can I update a subscriber's details using Mailingwork MCP Server?**
Yes, use `update_subscriber`. You provide the unique subscriber ID and specify what fields you need to change (like email or status). It updates the record in place.

**What is the best way to segment my audience with Mailingwork MCP Server?**
Use `list_tags` first to see all available tags. Then, ask your agent to filter using those tags or use `list_subscribers` to build a custom list based on multiple criteria.

**Does Mailingwork MCP Server handle GDPR compliance?**
Yes, the server is designed with GDPR in mind. You can check consent status and manage lists while adhering to regional privacy requirements through its tools.

**How do I list all available subscriber groups using the `list_lists` tool with Mailingwork MCP Server?**
You call the `list_lists` tool. This command retrieves a full catalog of every mailing list you own. The output provides the unique name, ID, and current total count for each group.

**What happens if I run into an error while using `send_transactional_email` with Mailingwork MCP Server?**
The server returns specific failure codes and detailed messages. Your agent reads this feedback, telling you exactly why the email failed—for instance, if the recipient address is invalid or if rate limits are hit.

**Can I run complex workflows using the `trigger_automation` tool with Mailingwork MCP Server?**
Yes, this tool lets your agent activate pre-built automations. You simply pass the required trigger parameters to execute multi-step processes without writing any code.

**What kind of authentication does Mailingwork MCP Server require for setup?**
The server requires your specific Mailingwork username and password credentials. Your AI client securely handles these inputs, allowing the agent to manage campaigns immediately after connection.

**Can I manage campaigns and track delivery?**
Yes. Create and schedule campaigns, track opens, clicks, bounces, and monitor sender reputation.

**Does Mailingwork use Basic Auth?**
Yes. Mailingwork uses **HTTP Basic Auth** with username and password against `api.mailingwork.de/webservice/v2`.

**Is Mailingwork GDPR-compliant?**
Yes. Mailingwork is a German email platform built for GDPR compliance with data processing in EU data centers.