# Plunk Email Marketing MCP

> Plunk Email Marketing MCP connects your AI agent directly to Plunk, giving you full control over email campaigns and audience data. Manage contacts, send transactional emails instantly, or track user behavior without leaving your chat window. It’s how developers automate marketing flows using natural language.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** transactional-email, event-tracking, audience-management, email-campaigns, subscription-management, developer-api

## Description

This MCP lets you manage your entire email lifecycle right through conversation. Forget switching tabs or logging into a separate dashboard just to update an address book entry or check campaign performance. You can use your AI agent to list every contact in the audience, grab details on one specific user, and even log custom actions like 'viewed pricing page' as they happen.

Need to send out alerts? The agent sends transactional emails—perfect for onboarding messages or account notifications. Plus, you can ask it to check saved templates or pull a list of active campaigns. Everything flows through the chat interface. By connecting this MCP via Vinkius, your AI client gains deep knowledge of Plunk’s entire API set. You're not just reading data; you're controlling contacts and automating complex marketing sequences using nothing but plain English.

## Tools

### create_or_update_contact
Add a new user to your list or update their information, including custom data fields.

### delete_contact
Remove an account from the Plunk audience permanently.

### get_contact_details
Fetch a comprehensive profile and all available data for one specific contact email address.

### list_email_campaigns
Retrieve a full list of marketing campaigns you have set up in Plunk.

### list_contacts
Get an overview and status list for every single contact currently in your audience.

### list_email_templates
Pull a listing of all the saved email designs you use for outreach.

### send_transactional_email
Send an immediate, non-marketing email to one or more users, ideal for alerts or system notifications.

### track_user_event
Record a custom action that a user took on your website so it can be analyzed later.

## Prompt Examples

**Prompt:** 
```
List all contacts in my Plunk audience.
```

**Response:** 
```
Retrieving contacts... I found several users, including 'john@example.com' (Subscribed) and 'jane@example.com' (Unsubscribed).
```

**Prompt:** 
```
Send a welcome email to 'test@example.com'.
```

**Response:** 
```
Sending transactional email... Done! The welcome message has been successfully queued for 'test@example.com' with subject 'Welcome to our platform!'.
```

## Capabilities

### Manage audience members
List all current contacts, get specific details on a user, create new records, or permanently delete accounts.

### Send alerts and notifications
Trigger immediate, transactional emails to one or multiple recipients for things like password resets or status updates.

### Track user activity
Log custom events when a user performs an action on your site, which helps segment and trigger workflows later.

### Oversee campaign assets
Retrieve lists of saved email templates or check the current status of active marketing campaigns.

### Update user metadata
Change contact information, like subscription states or internal notes, without manual entry.

## Use Cases

### Auditing a user's account status
A Product Manager needs to know if 'user@company.com' is subscribed, what their last recorded action was, and which template they might need for an alert. They ask the agent to get details, and it uses `get_contact_details` plus `track_user_event` to provide a complete picture in one response.

### Onboarding new feature users
A Growth Marketer just launched a paid tier. Instead of creating a manual workflow, they ask the agent to send a welcome email using `send_transactional_email` to all contacts who were updated in the last hour via `create_or_update_contact`.

### Cleaning up outdated data
The Ops Engineer runs monthly reports and finds thousands of stale contacts. They instruct the agent to list all contacts, filter for inactivity, and then systematically call `delete_contact` on the entire stale group.

### Pre-launch campaign check
A marketer wants to test a new email template before sending it live. They ask the agent to list all templates (`list_email_templates`), verify the name, and then run `list_email_campaigns` to confirm the right campaign ID.

## Benefits

- Skip the dashboard clutter. You don't need to navigate multiple screens in Plunk just to check who is subscribed or if a user needs an alert. The agent does it all from one prompt.
- Automate contact hygiene. Need to remove old, inactive users? Instead of manually searching and deleting them, you can ask the agent to run `delete_contact` immediately.
- Build behavioral triggers. When a customer takes a key action on your site, use `track_user_event` to log it instantly. This data then dictates which email sequence they receive later.
- Fast communication flow. Forget writing boilerplate code for simple notifications. Use `send_transactional_email` to send a personalized alert—it’s instant and conversational.
- Full visibility into assets. You can list all saved templates using `list_email_templates` or check the status of your campaigns via `list_email_campaigns`, keeping everything in conversation history.

## How It Works

The bottom line is you treat complex marketing operations like simple chat commands.

1. Subscribe to this MCP and provide your Plunk Secret Key in the Vinkius configuration.
2. Connect your AI agent—Claude, Cursor, Windsurf, or any compatible client—to the catalog via your chosen credentials.
3. Ask natural language questions like 'Send a welcome email to John Smith' or 'What contacts were updated today?' and let your agent execute the tools.

## Frequently Asked Questions

**Can I use Plunk Email Marketing MCP to send emails if the user isn't in my list?**
No. The agent requires you to first run `create_or_update_contact` or confirm the contact exists via `get_contact_details`. You can only send transactional emails to verified contacts.

**How does Plunk Email Marketing MCP handle data security?**
The agent uses your secure Plunk Secret Key, meaning all operations are authenticated through the platform's established API connection. We never store your credentials.

**What if I want to track a user event that isn't predefined?**
You can use `track_user_event` to log custom actions with any data you provide, allowing you to build unique segments based on specific user behavior.

**Does Plunk Email Marketing MCP list all my contacts or just the active ones?**
`list_contacts` retrieves a full roster of your audience. You can then filter that data using your agent to focus only on currently subscribed or active accounts.

**Is Plunk Email Marketing MCP better than a direct API connection?**
The advantage here is the natural language layer. Instead of writing code, you just tell the agent what needs doing—it handles the complex function calls for you.