# MailerSend MCP

> MailerSend lets your agent handle all transactional and marketing email tasks through natural conversation. You can send bulk emails using predefined templates, manage entire sending domains, and get deep analytics on opens, clicks, and bounces—all without touching a dashboard.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** transactional-email, template-management, email-analytics, domain-configuration, api-integration, bulk-email

## Description

This MCP connects your account to MailerSend so you don't have to manually navigate dashboards to run email campaigns or check metrics. Your agent can now handle everything from drafting a custom message using the send_transactional_email tool to confirming that your domain records are configured right via get_domain_details.

Need to blast out an announcement? You just tell your AI client, and it handles sending templated emails using send_templated_email. It automatically checks templates first (list_email_templates) before sending the message, ensuring you use variables like recipient name or order number correctly. Plus, if a campaign runs, your agent can immediately check list_sent_messages to track exactly what went out and analyze usage stats with get_date_analytics. When you connect this MCP through Vinkius, you put enterprise-grade email infrastructure right into your conversational workflow. You gain full visibility by checking detailed activity logs or reviewing suppression lists to keep your deliverability high.

## Tools

### get_date_analytics
Checks your overall usage statistics and campaign performance metrics.

### get_domain_details
Retrieves the current configuration and status of a specific sending domain.

### get_message_info
Checks the detailed delivery and current status of a single message ID.

### get_account_limits
Shows your current plan quotas, helping you know when you need to scale up.

### get_template_details
Fetches the specific contents and variables of a saved email template.

### list_email_activities
Retrieves detailed historical logs showing every email event that occurred in your account.

### list_sending_domains
Provides a list of all verified domains currently configured for sending emails.

### list_sent_messages
Lists recent messages, allowing you to confirm who received what and when the message was sent.

### list_email_templates
Provides a catalog of all saved and available email templates within your account.

### list_domain_webhooks
Retrieves the current webhook notification configurations for your domains.

### send_transactional_email
Sends a custom-written email message that does not rely on an existing template.

### send_templated_email
Sends an email using one of your pre-approved templates, filling in variables like names or IDs.

## Prompt Examples

**Prompt:** 
```
Show sending analytics and domain health status.
```

**Response:** 
```
Sending (7 days): 4,560 emails. Delivered: 4,468 (98% ✅). Opens: 1,824 (41%). Clicks: 456 (10%). Bounced: 68 (1.5%). Spam complaints: 4 (0.09%). Domains: 2. 'app.company.com' — Verified ✅, SPF ✅, DKIM ✅, DMARC ✅. 'notify.company.com' — Verified ✅, DMARC ⚠️ (policy: none).
```

**Prompt:** 
```
List email templates and send a password reset email.
```

**Response:** 
```
Templates: 6. 'Welcome' (used 1,200x), 'Password Reset' (890x), 'Invoice' (456x), 'Shipping Notification' (334x), 'Verification' (1,500x), 'Feedback Request' (220x). Email sent! ✅ Template: 'Password Reset'. To: sarah@company.com. Variables: {name: 'Sarah', reset_link: 'https://...'}. Delivered in 0.8s.
```

**Prompt:** 
```
Show suppression list and recent bounce details.
```

**Response:** 
```
Suppression list: 145 addresses. Hard bounces: 89. Spam complaints: 34. Manual: 22. Recent bounces (48h): 12. Hard: 'user@oldomain.com' (domain expired), 'test@fake.io' (mailbox not found). Soft: 'info@bigcorp.com' (mailbox full, retry in 4h). Bounce rate trend: 1.5% → 1.2% (improving ⬇️).
```

## Capabilities

### Send bulk and custom emails
Your agent sends immediate, personalized messages using predefined templates or crafts entirely new text on the fly.

### Audit domain health
Checks if your sending domains are verified and confirms essential DNS records like SPF and DKIM are correctly configured.

### Analyze campaign performance
Retrieves detailed usage statistics, including total emails sent, open rates, click percentages, and bounce trends.

### Manage recipient lists
Checks suppression list sizes and reviews recent bounce details to ensure you aren't emailing inactive addresses.

### Review message history
Lists specific messages that have been sent, allowing you to confirm delivery status and timing for debugging.

## Use Cases

### Troubleshooting a failed notification email
A developer needs to know why a password reset didn't go out. They ask their agent to check the status using get_message_info and can immediately see if the message was rejected or if it’s pending, saving hours of investigation.

### Running monthly marketing performance reviews
A product manager wants a summary of last month's campaign health. They ask their agent to run get_date_analytics and receive an instant breakdown of opens vs. clicks, which they can use for stakeholder meetings.

### Setting up a new microservice email alert
A DevOps engineer needs to send critical alerts programmatically. They use the agent to confirm domain readiness with list_sending_domains and then execute send_transactional_email for reliable, plain-text messaging.

### Updating a complex welcome series
A content team needs to update their onboarding flow. They first use list_email_templates to see the existing 'Welcome' template details and then instruct the agent to send_templated_email using the updated variables for testing.

## Benefits

- Domain Health: Use get_domain_details to check if your sending domains are verified and confirm critical records like SPF or DKIM are set up correctly. This prevents hard bounces before you even send a single email.
- Campaign Visibility: Get immediate performance metrics using get_date_analytics. You'll instantly know the opens, clicks, and bounce rate of any campaign without needing to pull reports into a spreadsheet.
- Template Reliability: Never write boilerplate code for an email again. List email templates first, then use send_templated_email so your agent fills in variables correctly, ensuring consistency across all communications.
- Debugging Speed: When something goes wrong, list_sent_messages lets you check the exact status of a message instantly. You can pinpoint whether delivery failed or if the issue was on the recipient's end.
- Compliance Tracking: Keep your sending practices clean by reviewing suppression lists and bounce data through the MCP, helping reduce spam complaints and maintain high deliverability scores.

## How It Works

The bottom line is that your AI client treats email infrastructure like another conversational tool.

1. Subscribe to this MCP in Vinkius and input your unique MailerSend API token.
2. Tell your AI client what email task you need, whether it's sending a message or checking metrics.
3. Your agent executes the necessary tools, retrieves the data (like domain details or analytics), and reports the status back to you in plain text.

## Frequently Asked Questions

**How do I check my domain health using the MailerSend MCP?**
You use get_domain_details. This tool confirms if your sending domains are verified and verifies critical records like SPF, DKIM, and DMARC status immediately.

**Can I send a simple email that doesn't use a template with MailerSend MCP?**
Yes. You call the send_transactional_email tool. This allows you to write custom text on the fly instead of relying on existing templates.

**What information does get_date_analytics provide via MailerSend MCP?**
It provides key usage statistics over a set period, including total emails sent, open rates, click-through rates, and the percentage of bounces.

**Which tool should I use to see what templates I can send?**
You start by using list_email_templates. This gives you a full catalog of all available saved templates that your agent can then reference when sending messages via send_templated_email.

**How do I confirm if an email was actually delivered?**
You use get_message_info. This tool checks the specific message ID and tells you its current delivery status, helping you troubleshoot failures instantly.