# Smaily MCP

> Smaily MCP Server connects your email marketing automation to any AI agent. Manage contacts, run campaigns, and update autoresponders entirely through natural conversation. Use it to list all subscribers, check campaign performance history, or trigger a specific customer workflow without touching the Smaily dashboard.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** subscriber-management, campaign-tracking, email-automation, marketing-analytics, newsletter-management

## Description

Connect your Smaily account directly to your AI client. You'll manage every part of your email marketing stack—subscriber lists, campaigns, and autoresponders—using nothing but natural conversation. This server gives you access to 11 tools that let you interact with all your contact data and campaign history without ever touching the main Smaily dashboard.

**Manage Subscriber Records**
You can pull a comprehensive list of every person in your database using `list_subscribers`. Need more detail on one specific user? Use `get_subscriber_details` to grab their entire profile, including any custom fields or tags you've set up for them. When you need to grow the list, simply use `create_subscriber` to add a brand-new contact record into your active subscriber pool. If someone moves or unsubscribes, `delete_subscriber` lets you permanently remove an existing user from your database.

**Run & Track Campaigns**
To check what's happened with your outreach, start by calling `list_email_campaigns`. This shows you a full rundown of every past and scheduled campaign. You can then drill down into performance metrics for one specific effort using `get_campaign`, which pulls all the metadata and stats for that single named campaign. To see what kind of message designs you're working with, use `list_email_templates` to get a directory of available messages; if you need the full code or text for a template, run `get_template`.

**Automate Workflows & Sending Emails**
When it comes to automated sequences, you can view every autoresponder flow you've built by running `list_automations`. Need to know exactly how that workflow operates? Use `get_automation` to retrieve the specific logic and details of a configured flow. When you want to manually jumpstart a sequence for a client or a group, trigger it instantly with `send_automation_email`, specifying the user or segment. 

**Core Functionality Overview**
Besides managing contacts, this server lets you build out your campaign infrastructure by providing tools that list all available message templates (`list_email_templates`) and pull template metadata (`get_template`). It gives you granular control over adding new people to the mailing list (`create_subscriber`), deleting old ones (`delete_subscriber`), viewing who's actually subscribed (`list_subscribers`), checking specific user data (`get_subscriber_details`), reviewing campaign performance history (`list_email_campaigns` and `get_campaign`), listing all active automated sequences (`list_automations`), and manually executing those flows immediately (`send_automation_email`).

## Tools

### delete_subscriber
Permanently removes an existing subscriber from your database.

### get_automation
Retrieves the specific details and logic for a configured automated workflow or autoresponder.

### get_campaign
Pulls performance metrics and metadata for one specific, named email campaign.

### get_template
Retrieves the full HTML/text details of an available email message template.

### create_subscriber
Adds a brand-new contact record into your Smaily subscriber list.

### get_subscriber_details
Grabs all the profile information for a single subscriber, including custom fields and tags.

### list_automations
Shows a list of every automated workflow or autoresponder you have set up in Smaily.

### list_email_campaigns
Lists all past and scheduled email campaigns for review.

### list_subscribers
Returns a comprehensive list of every subscriber currently held in your database.

### list_email_templates
Provides a directory of all message templates available to use in your emails.

### send_automation_email
Manually triggers an automated email sequence for a specific user or segment.

## Prompt Examples

**Prompt:** 
```
List all subscribers in Smaily.
```

**Response:** 
```
I've retrieved your contact list. You have 500 subscribers, including 'john@example.com' and 'alice@smith.co'.
```

**Prompt:** 
```
Show me the campaign performance for all email campaigns sent this quarter with engagement trends.
```

**Response:** 
```
18 campaigns sent this quarter. Total sent: 67,800. Overall open rate: 32.4% (up from 28.1% last quarter). Click rate: 5.8% (+0.9%). Unsubscribe rate: 0.14%. Top performer: "Spring Collection Launch" (45.2% open, 9.8% click). Lowest: "Monthly Digest #3" (18.4% open). A/B test insights: personalized subjects outperform generic by 34%. Best send time: Tuesday 10 AM. Automation emails (6 workflows): 89,000 sent, 42% open rate. List growth: +1,234 net subscribers.
```

**Prompt:** 
```
Create a new subscriber and add them to the VIP customer automation workflow.
```

**Response:** 
```
Subscriber created: Maria Santos (maria@meridian.io). Tags: VIP, Enterprise, Q2-2025. Custom fields: Company (Meridian Corp), Role (VP Marketing), Source (Referral). Added to automation: "VIP Customer Journey". Workflow steps: Day 0 - Welcome email (personalized). Day 3 - Exclusive preview of new features. Day 7 - Personal thank you from CEO. Day 14 - Quarterly review invitation. Day 30 - Loyalty reward notification. Subscriber status: Active. GDPR consent: recorded.
```

## Capabilities

### Manage Subscriber Records
You can list all contacts or retrieve deep profile details for specific users using tools like `list_subscribers` and `get_subscriber_details`.

### Run & Track Campaigns
Check the history and performance of past campaigns, and get details about any scheduled outreach using `list_email_campaigns` and `get_campaign`.

### Build Automated Workflows
View existing autoresponder flows (`list_automations`) and trigger a specific email sequence instantly with `send_automation_email`.

### Handle Email Templates
List all available message templates or pull the metadata for a single template using `list_email_templates` and `get_template`.

### Modify Contact Lists
Add new subscribers with `create_subscriber` or clean up your database by removing contacts with `delete_subscriber`.

## Use Cases

### Auditing a Dormant List
A marketing manager needs to find all subscribers who haven't opened an email in three months. They ask their agent: 'List inactive subscribers.' The agent uses `list_subscribers` and filters the results, giving the exact list of emails they need to re-engage.

### Launching a Targeted Re-engagement Campaign
A product team needs to send an urgent announcement. They first check templates using `list_email_templates` to find the best design, then list recent campaigns with `list_email_campaigns` for historical context. Finally, they use `send_automation_email` on a specific segment.

### Onboarding a New Enterprise Client
The sales engineer needs to add the new client's 50 contacts immediately and tag them correctly. They prompt: 'Create 50 subscribers with tags X, Y, Z.' The agent runs `create_subscriber` repeatedly and updates records in bulk.

### Troubleshooting a User Flow
A user reports that the onboarding sequence isn't running. Instead of checking multiple dashboards, they ask their agent to 'Check the details for the VIP journey.' The agent uses `get_automation` and returns the exact workflow steps needed.

## Benefits

- Checks your entire contact list instantly. Instead of manually exporting data to Excel just to check who's active, use `list_subscribers` and get the full roster directly in the response.
- Never miss a performance metric again. You can query past outreach using `get_campaign` or `list_email_campaigns`, getting open rates, click-through data—all without leaving your agent chat window.
- Automates complex follow-ups on demand. Need to kick off the 'Welcome Back' sequence for a user? Use `send_automation_email` and pass the necessary subscriber ID right through natural conversation.
- Keeps your database clean by programmatically managing users. If someone unsubscribes, use `delete_subscriber`. If you sign up a new lead, run `create_subscriber` immediately.
- Quickly reference message standards. Need to know what boilerplate text or design assets are available? Use `list_email_templates` to see every option in your catalog.

## How It Works

The bottom line is: your AI client handles the API calls, so you don't have to switch between dashboards to run marketing tasks.

1. Subscribe to the server and enter your Smaily Subdomain, API User, and API Password into your AI client.
2. Ask your agent to perform a marketing task (e.g., 'List all subscribers who haven't opened an email in 6 months').
3. The agent calls the relevant tools (`list_subscribers`, `get_subscriber_details`) and returns structured data directly into the chat.

## Frequently Asked Questions

**How do I check who is in my list using Smaily MCP Server and list_subscribers?**
You just ask for it. Your agent runs `list_subscribers` and returns a comprehensive, structured list of every contact in your database directly to you.

**Can I manually send an email using the Smaily MCP Server and send_automation_email?**
Yes. You use `send_automation_email` when you need to trigger a specific, predefined workflow for a user or segment immediately.

**What tool do I use if I want to check the performance of an old campaign? (get_campaign)**
Use `get_campaign`. This tool lets you pull specific metrics and metadata for one named campaign, so you don't have to sift through a mountain of data.

**Does the Smaily MCP Server help me add new subscribers? (create_subscriber)**
Yes. Use `create_subscriber` when you need to programmatically add one or more contacts to your list from an external source.

**What tool should I use to clean up old contacts using Smaily MCP Server and `delete_subscriber`?**
You use the `delete_subscriber` tool. This function removes a specified contact from your database entirely. It's useful for cleaning out inactive or incorrect entries when you no longer need them in your active list.

**If I need to view all my configured automated workflows, which tool should I use with Smaily MCP Server and `list_automations`?**
The `list_automations` tool fetches a catalog of your existing autoresponder setups. You'll get the names and general status of every workflow you have running or paused in your account.

**What is the process for checking the structure and content of an existing message layout using Smaily MCP Server and `get_template`?**
Call the `get_template` tool. This retrieves detailed metadata about a specific template, letting you review its available fields, design components, and current status before sending it out.

**Before building a campaign, what tool do I use to check the entire catalog of available messages using Smaily MCP Server and `list_email_templates`?**
Use the `list_email_templates` tool. This provides an overview of every message template format available in your account, helping you select the right visual style for a new outreach effort.

**Can I list all my email templates using my AI agent?**
Yes! Use the `list_email_templates` tool to retrieve a comprehensive list of all message templates available in your Smaily account.