# Smaily Alternative MCP

> Smaily Alternative manages your entire email marketing stack through natural conversation. Use this server to list, add, delete subscribers, inspect templates, and trigger campaigns directly from your AI client. You get full control over complex automation workflows without touching the dashboard.

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

## Description

This **Smaily Alternative MCP Server** gives you total hands-on control of your entire email marketing stack. You connect it to your AI client and manage everything—from updating a single contact record to firing off complex automation sequences—all through natural conversation. Forget digging through dashboards; here’s how you run the show.

### **Subscribers Management**
When you need to handle contacts, you've got three tools ready: use `list_subscribers` to pull a report showing every active contact in your database. You can add new people using `add_update_subscriber`, or if someone's details change, you just run `add_update_subscriber` again to modify their existing record. If you need to wipe a user from the list completely, `delete_subscriber` handles that for you.

### **Template Inspection**
Before you hit send on anything, you gotta check your messaging. Use `list_templates` to get an overview of every email template saved in your account. If you want to deep-dive into a specific design or make sure the branding is perfect, run `get_template`, which fetches all the details for a template by its name or ID.

### **Campaign Control and Sending**
Managing campaigns means knowing exactly what's going out and when. You can view every campaign you’ve set up—whether it's active or archived—by calling `list_campaigns`. To check the status, content, or performance data for one specific send, run `get_campaign` using its unique ID. When it's time to blast an email out, use `send_campaign` to fire off a selected campaign immediately, bypassing any scheduled queues on the web interface.

### **Automation Workflows**
For lead nurturing and complex sequences, you rely on automations. First, see what’s built by running `list_automations` to get a comprehensive list of every workflow defined in your account. If a specific subscriber needs that automated process kicked off right now, just use `trigger_automation`, passing the ID of the automation and the target subscriber's details. This lets you start lead nurturing instantly without manual intervention.

## Tools

### add_update_subscriber
Adds a new contact to your mailing list or modifies existing details for an active subscriber.

### delete_subscriber
Removes a specific user from your Smaily contact lists entirely.

### get_campaign
Retrieves detailed information, including status and content, for one specified campaign ID.

### get_template
Fetches the specific details of a saved email template by its name or ID.

### list_automations
Shows you a comprehensive list of all automated workflows currently set up in your account.

### list_campaigns
Returns a list containing the IDs and names of every campaign you've created.

### list_subscribers
Pulls a report listing all active subscribers in your contact database.

### list_templates
Provides an overview of all the email templates you have saved and available to use.

### send_campaign
Immediately sends a selected campaign out to your audience, bypassing scheduling queues.

### trigger_automation
Manually kicks off an automation workflow for one or more specific subscribers.

## Prompt Examples

**Prompt:** 
```
List all my current email campaigns in Smaily.
```

**Response:** 
```
I've retrieved your campaigns. You have 3 active campaigns: 'Summer Sale 2024' (ID: 101), 'Monthly Newsletter' (ID: 102), and 'Product Update' (ID: 103). Would you like details on any of these?
```

**Prompt:** 
```
Add test@example.com to my subscriber list with the name 'John Doe'.
```

**Response:** 
```
I've added test@example.com to your Smaily subscribers with the provided fields. The contact is now active in your list.
```

**Prompt:** 
```
Trigger the welcome automation (ID: 50) for user hello@world.com.
```

**Response:** 
```
Automation 50 has been successfully triggered for hello@world.com. They should receive the first email in the workflow shortly.
```

## Capabilities

### Manage Subscribers
Add new contacts, update fields for existing users, or delete records from your mailing list.

### Retrieve Campaign Details
Get specific data on campaigns—like their ID or status—or list all active and archived campaigns available to send.

### Run Automations
List your defined automation workflows and trigger them instantly for any specified subscriber, starting lead nurturing immediately.

### Inspect Templates
View details of saved email templates to ensure consistent branding and correct content before scheduling a send.

### Send Campaigns
Execute an entire campaign send immediately, bypassing the standard web dashboard flow.

## Use Cases

### The Quarterly Review
A marketing manager needs to know if last quarter's 'Holiday Sale' campaign actually went out. Instead of logging into the dashboard and searching through archives, they ask their agent: 'What is the status of Campaign ID 105?' The agent runs `get_campaign`, confirming it was sent successfully.

### The Cold Lead Conversion
An SDR gets a promising cold lead. They can't wait for the manual process. They ask their agent to 'Add test@example.com and put them in the welcome sequence.' The agent uses `add_update_subscriber` followed by `trigger_automation`, getting the lead started instantly.

### The Emergency Send
A sudden product launch requires an immediate announcement email, bypassing the usual review process. A team member tells their agent: 'Send out the Product Launch campaign right now.' The agent executes `send_campaign` immediately.

### The Cleanup Crew
Your team identifies a list of inactive or bounced emails that need to be removed from the master list. They instruct their agent: 'Delete these 50 subscribers.' The agent runs `delete_subscriber`, keeping your contact list clean and compliant.

## Benefits

- Stop dashboard hopping. You can list all campaigns using `list_campaigns` and get their full details with `get_campaign`, keeping your workflow inside the chat window.
- Instant lead action. Instead of going through a funnel UI, you use `add_update_subscriber` and immediately follow up by running `trigger_automation` for that specific user.
- Template consistency is guaranteed. Before sending anything, check your message with `list_templates` or `get_template` to confirm the branding hasn't slipped.
- Control complex flows directly. You can list all available workflows with `list_automations` and kick them off immediately using `trigger_automation`, regardless of their original schedule.
- Real-time data access. Querying campaign performance or subscriber lists via `list_subscribers` gives you the necessary stats without needing to run a separate report export.

## How It Works

The bottom line is: your AI client talks directly to Smaily's backend, handling all the API calls so you don't have to leave your chat window.

1. First, subscribe to this server and enter your Smaily Subdomain, API Username, and API Password.
2. Next, talk to your AI client. You'll ask it to perform an action—for instance, 'List all my campaigns.'
3. The agent runs the necessary tool (like `list_campaigns`) and hands you a clean list of results or confirmation that the task was completed.

## Frequently Asked Questions

**How do I check which campaigns are available? (list_campaigns)**
You run `list_campaigns`. This returns a list of all campaign IDs and names, letting you know exactly what's ready to go or needs updating.

**What if I need to change someone’s email? (add_update_subscriber)**
Use `add_update_subscriber`. You just provide the user's ID and the new field data. It handles both adding a brand-new contact and modifying an existing one.

**Can I manually restart a nurture sequence? (trigger_automation)**
Yes, use `trigger_automation`. You specify the workflow ID and the subscriber's email. The agent fires the automation, restarting the welcome flow immediately.

**Where do I find my saved message layouts? (list_templates)**
Run `list_templates`. This gives you a full inventory of all your reusable templates so you can confirm they're up-to-date before writing a new campaign.

**How do I use `delete_subscriber` to clean up old or inactive contacts?**
The `delete_subscriber` tool permanently removes a contact from your list. When you run this, remember it’s irreversible data cleanup—it won't just deactivate them; they're gone from Smaily.

**What specific performance metrics does the `get_campaign` tool return?**
It returns deep details on a single campaign, including its current status, send history, and key performance indicators (KPIs). This is better than just listing campaigns because you get the actual data.

**If I need to know my total audience size, how should I use `list_subscribers`?**
Running `list_subscribers` retrieves a comprehensive list of every contact in your system. This allows you and your agent to count the current roster or prepare bulk data for export.

**What limitations should I be aware of when executing a send via `send_campaign`?**
The `send_campaign` tool executes sends immediately. For massive audience lists, watch out for potential API rate limits imposed by Smaily to ensure your agent doesn't fail halfway through.

**Can I add a new subscriber with custom fields using the AI?**
Yes! Use the `add_update_subscriber` tool. You can provide the email and a JSON string for the `fields` parameter to include custom data like names or preferences.

**How do I trigger an automated email for a specific user?**
Simply use the `trigger_automation` tool by providing the `automation_id` and the subscriber's `email`. This will immediately start the workflow for that contact.

**Is it possible to see the content of my email templates?**
Yes, you can use `list_templates` to find the ID and then `get_template` to retrieve the full details and structure of a specific email template.