# Mailsoftly MCP for AI Agents AI Agent Connect

> Mailsoftly MCP lets you manage your entire email marketing operation through an AI agent. You can build subscriber lists, create new contacts, and trigger campaign sends using natural language. It bridges the gap between your marketing data and your AI workspace, making it easy to handle audience segmentation and engagement tracking without switching tabs.

## Overview
- **Category:** crm-sales
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_q10ioCoQpT2FNEYbfTNZTXTaRzNzDdNKosKc0h93/ai-agent-connect
- **Tags:** email-campaigns, subscriber-management, contact-lists, engagement-tracking, marketing-analytics

## Description

Imagine you're in the middle of a strategy session with your AI agent and you need to check who's on your VIP list or see how last week's newsletter performed. Instead of jumping back into a separate dashboard, typing in login credentials, and hunting through menus, you just ask. This Connector gives your agent the keys to your Mailsoftly account. You can tell it to grab a list of subscribers, create a new contact from a spreadsheet, or even fire off a campaign to a specific group of people instantly. It handles the heavy lifting of interacting with the Mailsoftly API so you can stay focused on the actual marketing. By connecting this through the Vinkius catalog, you turn your AI into a marketing operations assistant that knows your audience and can execute tasks in real-time. It's about moving from how do I do this in the app to just do it.

## Tools

### add_contact_to_list
Subscribes a specific contact to a mailing list. It's great for moving leads into targeted segments.

### get_campaign_click_data
Retrieves engagement metrics for a sent campaign. Use this to see which links people actually clicked.

### list_marketing_campaigns
Lists every marketing campaign in your account. This provides a high-level view of your entire history.

### get_campaign_details
Pulls specific info for a single campaign. Use this to check metadata or status quickly.

### send_campaign_to_all
Triggers an email send for a specific campaign. It's the fastest way to launch a blast via your agent.

### list_sent_history
Shows all campaigns that have already been sent. This helps you keep track of past marketing efforts.

### create_base_contact
Adds a new contact to your database. This lets you populate your audience without manual data entry.

### list_subscriber_collections
Shows all your contact lists. It helps the agent understand your current audience segments.

## Prompt Examples

**Prompt:** 
```
Who's on my VIP list and how many people are in it?
```

**Response:** 
```
I've checked your subscriber collections. Your 'VIP Customers' list currently has 1,240 subscribers. Would you like me to list the most recent additions or check the engagement for the last campaign sent to this group?
```

**Prompt:** 
```
Add hello@example.com to the 'Early Bird' list.
```

**Response:** 
```
Done. I've added hello@example.com to your 'Early Bird' list. They are now set to receive all future communications tied to that segment.
```

**Prompt:** 
```
How did the 'Summer Sale' campaign perform?
```

**Response:** 
```
Here are the results for the 'Summer Sale' campaign:

- **Total Clicks**: 342
- **Unique Subscribers**: 210
- **Click-Through Rate**: 16.2%

Let me know if you'd like to see the history for any other campaigns.
```

## Capabilities

### Trigger email campaign dispatches
Send out your planned marketing emails to your target audience using a simple command.

### Create new subscriber records
Add new people to your database without manual data entry.

### Retrieve click-through engagement data
See exactly how many people interacted with the links in your sent emails.

### Manage subscriber list collections
View and organize your various mailing lists and audience segments.

### View historical campaign performance
Check the status and history of every campaign you've sent in the past.

### Add specific contacts to mailing lists
Move individual leads into specific lists to ensure they get the right content.

## Use Cases

### Syncing new leads from a CSV
A growth engineer needs to sync 50 new leads. They ask the agent to use create_base_contact and add_contact_to_list to populate the VIP segment.

### Auditing a recent newsletter
A marketer wants to see if the last blast worked. They ask the agent for click data on a specific campaign ID using get_campaign_click_data.

### Moving a hot lead to a drip
A sales lead comes in and needs to be added to a drip. The user tells the agent to add the email to a specific list using add_contact_to_list.

### Reviewing campaign history
A manager wants a full overview of the month. They ask the agent to list_marketing_campaigns to get a full history of all past promos.

## Benefits

- No more tab-switching between your CRM and Mailsoftly. You can stay in Cursor or Claude while managing your audience.
- Faster list management using add_contact_to_list to move leads into segments instantly.
- Real-time engagement tracking with get_campaign_click_data to see what's working right now.
- Automated contact creation using create_base_contact to keep your database fresh without manual work.
- Quick campaign audits with list_sent_history to review past performance in seconds.
- Instant campaign execution using send_campaign_to_all to launch your messages the moment they're ready.

## How It Works

The bottom line is you get a direct voice command to your email marketing backend.

1. Subscribe to the Mailsoftly MCP via Vinkius.
2. Provide your Mailsoftly API Key in the configuration.
3. Ask your AI agent to manage your lists or send emails.

## Frequently Asked Questions

**Can I use Mailsoftly MCP to send emails?**
Yes, you can trigger campaign sends using the send_campaign_to_all tool directly through your AI client.

**How do I add new contacts to my Mailsoftly account?**
You can tell your agent to create a new contact using the create_base_contact tool, and it will handle the database entry for you.

**Can I see how many people clicked my links?**
Yes, you can use the get_campaign_click_data tool to get specific engagement metrics for any sent campaign.

**Does this Connector help with list management?**
Definitely. You can use list_subscriber_collections to see your lists and add_contact_to_list to move people around.

**Is it possible to see my past marketing history?**
Yes, the agent can use list_sent_history to show you everything you've sent in the past.

**How do I connect Mailsoftly to my AI agent?**
You just need to subscribe to the Connector on Vinkius and provide your Mailsoftly API Key.

**How do I find my Mailsoftly API Key?**
Log in to your Mailsoftly account and navigate to Account Settings or API to generate and copy your unique authorization token.

**What fields are required to add a contact to a list?**
You must provide the `email` address and the unique `contact_list` ID. Providing a `first_name` is optional but recommended.

**Can I see how many people clicked a link in a sent campaign?**
Yes, use the `get_campaign_click_data` tool with the target campaign ID to retrieve detailed click engagement statistics.