# Mailjet MCP

> Mailjet provides full API control over email marketing and transactional messaging directly through your AI agent. Send specific emails, manage entire contact lists, segment audiences by behavior, or check campaign performance—all without writing code. Connect Mailjet to any compatible client to automate complex communications workflows.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** transactional-email, marketing-campaigns, email-tracking, subscriber-lists, api-delivery

## Description

This MCP lets you treat your email platform like another API endpoint for your AI client. You'll stop manually logging into a dashboard just to send an update or see who opened the last blast. Instead, you talk to your agent and it executes actions across Mailjet. Need to onboard 50 new leads? Your agent handles listing contacts, adding them to the correct segment, and then sending a welcome sequence—all in one conversational turn. You can pull campaign data, checking open rates or bounce counts, and immediately use that information to ask your agent to draft an adjustment for next time. It's about building complex workflows entirely through natural language prompts, letting you manage everything from list maintenance to high-volume sending without ever touching a dashboard manually. The Vinkius catalog makes connecting this power simple, giving your agent access to the entire suite of email management tools.

## Tools

### list_marketing_campaigns
Provides a full list of all marketing campaigns you've run through Mailjet.

### list_all_contacts
Generates a comprehensive roster, listing every single contact stored within your Mailjet account.

### get_campaign_details
Fetches deep details and configuration information about one specific campaign.

### list_subscriber_lists
Retrieves the names and IDs of every contact segment or mailing list available in your account.

### send_transactional_email
Dispatches an email immediately using the full v3.1 API structure for transactional needs.

### add_contact_to_list
Subscribes an existing contact to a specific, targeted mailing list.

### get_campaign_performance
Retrieves key metrics like open and click rates for a finished campaign.

### create_new_contact
Adds a brand-new person to your overall contact database, requiring at least an email address.

## Prompt Examples

**Prompt:** 
```
Send a transactional email to 'passenger@example.com' with subject 'Boarding Pass'.
```

**Response:** 
```
I've sent the email. The message has been queued by Mailjet. You can track the delivery status using the campaign tools.
```

**Prompt:** 
```
List all active contact lists in my Mailjet account.
```

**Response:** 
```
I've retrieved your contact lists. You have 3 active lists: 'Newsletter Subscribers', 'Product Updates', and 'Transactional Users'.
```

**Prompt:** 
```
Show performance stats for campaign ID '12345'.
```

**Response:** 
```
I've fetched the statistics. For campaign 12345, you have an open rate of 22.5% and a click rate of 3.2% across 5,000 recipients.
```

## Capabilities

### Send personalized emails
You can send single or bulk transactional messages that include HTML content, attachments, and specific variables for personalization.

### Manage contact lists
The MCP lets you retrieve all contacts in your account, list existing subscriber groups, and add new subscribers to any specified list.

### Monitor campaign performance
You can pull real-time statistics for past campaigns, including open rates, click counts, and bounce data.

### View campaign details
The agent retrieves deep configuration settings and status reports for specific marketing campaigns.

## Use Cases

### Auditing lead flow after a webinar
The Marketing Manager asks the agent: 'Which attendees from last week's webinar weren't added to the Product Update list?' The agent uses list_all_contacts and add_contact_to_list, providing an immediate report of missing subscribers.

### Responding to a failed campaign
A developer asks: 'What caused the high bounce rate on Campaign ID XYZ?' The agent runs get_campaign_performance, reports the exact metric failure, and suggests checking the mailing list metadata via get_campaign_details.

### Launching a critical announcement
The Ops Engineer needs to send an urgent service update. Instead of logging into the GUI, they prompt the agent to use send_transactional_email directly with the required JSON body structure and attachments.

### Segmenting old contacts for cleanup
The team wants to find all contacts who haven't engaged. They ask the agent to list_all_contacts, then filter that data through a custom prompt to identify non-engaged users for review.

## Benefits

- Instead of manually checking analytics, you can ask the agent to get_campaign_performance and immediately see open rates or bounce counts for any past mailing.
- You eliminate manual contact management. Use create_new_contact followed by add_contact_to_list to onboard leads automatically without copy-pasting emails into a spreadsheet.
- Need to run an immediate, non-marketing message? The send_transactional_email tool lets you dispatch critical alerts or password resets instantly via your agent.
- Don't waste time listing campaigns one by one. list_marketing_campaigns gives you the full scope of your efforts in a single query.
- You can easily audit your audience by using list_all_contacts to pull every record, then use list_subscriber_lists to see which segments exist.

## How It Works

The bottom line is that you talk to your AI client once, and it handles the complex API interactions with Mailjet for you.

1. First, you subscribe to the Mailjet MCP on Vinkius and enter your API Public Key and Secret Key.
2. Next, you instruct your AI agent using natural language commands—for example, 'List all active contact lists.'
3. Finally, your agent executes the necessary tool calls, returning structured data (like a list of contacts or performance stats) right into your chat window.

## Frequently Asked Questions

**How do I send an urgent, one-off message using Mailjet MCP?**
You use the send_transactional_email tool. This is designed for immediate, critical messages (like password resets) that aren't part of a planned marketing campaign.

**Can I see all my existing contact lists using Mailjet MCP?**
Yes, you call list_subscriber_lists. This returns a definitive roster of every segment and mailing group available in your account.

**Which tool should I use to find out how many people opened my last email from Mailjet?**
You need get_campaign_performance. This tool pulls the specific metrics, including open rates and click counts, for a given campaign ID.

**Is there a way with Mailjet MCP to add contacts that I just signed up manually?**
Yes, you can use create_new_contact first to put the person in your database, and then follow it up with add_contact_to_list to place them into the correct segment.

**Does Mailjet MCP help me manage my entire contact list?**
Yes. You can use list_all_contacts to retrieve everyone, and then you have tools like add_contact_to_list to keep your segments clean and updated.

**Which version of the Mailjet API does this server use?**
This server uses Mailjet REST API v3 for resource management (contacts, lists, campaigns) and the modern v3.1 Send API for reliable email delivery.

**Can I send bulk emails using the agent?**
Yes, the `send_transactional_email` tool supports the full v3.1 structure, allowing you to include multiple message objects in a single call.

**How do I find my API Key and Secret?**
Log in to your Mailjet account and navigate to Account Settings > API Key Management to find or generate your credentials.