# Acelle Mail MCP MCP > Acelle Mail MCP connects your self-hosted or cloud email platform directly to any AI client. You can manage mailing lists, add subscribers, and monitor campaign status without touching a dashboard. It lets you run complex marketing tasks—like listing all campaigns or fetching specific list details—just by talking to your agent. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-campaigns, subscriber-management, mailing-lists, open-source, newsletter-automation ## Description This connector gives your AI agent direct access to the core functions of Acelle Mail. Instead of logging into a separate web portal, your agent handles everything from managing mailing lists to tracking open rates and campaign statuses using natural conversation. You can ask it to list all active campaigns or query specific subscribers within a directory. It's built for teams that need real-time data on subscriber count and audience details right where they work. When you connect this MCP via Vinkius, your agent handles the entire workflow: running checks, adding members, and pulling campaign metadata seamlessly. ## Tools ### add_acelle_subscriber Adds a single new email address to an existing mailing list. ### create_acelle_list Creates an entirely new, empty directory for your subscribers. ### get_acelle_campaign Retrieves the full details and metadata for a specific campaign by its ID. ### get_acelle_list Pulls detailed configuration information about an existing mailing list directory. ### list_acelle_campaigns Returns a comprehensive list of all campaigns, both active and historical. ### list_acelle_lists Provides an overview listing every single mailing directory you have set up. ### list_acelle_subscribers Fetches a list of all current subscribers belonging to a specified directory. ## Prompt Examples **Prompt:** ``` List all my mailing lists in Acelle Mail. ``` **Response:** ``` I've retrieved your mailing lists. You have 3 active directories: 'Main Newsletter', 'Beta Testers', and 'Old Customers'. Which one would you like to see subscribers for? ``` **Prompt:** ``` Add 'john.doe@example.com' to the 'Main Newsletter' list (UID: 10293). ``` **Response:** ``` Subscriber added! I've registered john.doe@example.com in the 'Main Newsletter' list. He is now active and ready to receive your upcoming campaigns. ``` **Prompt:** ``` Show me the status of my latest email campaign. ``` **Response:** ``` I've fetched your campaigns. The 'November Product Update' (UID: camp_88231) is currently 'Sending'. It has already reached 85% of its recipients with an open rate of 12%. ``` ## Capabilities ### Build or retrieve mailing lists The system can list all existing directories and programmatically create new ones for segmented audiences. ### Manage subscriber records You can query specific members of any list, verify counts, or add new subscribers directly through your agent conversation. ### Track campaign performance The MCP retrieves details and status for past and current email outreach campaigns. ### Audit audience reach Fetch full list details to verify the total size of your marketing audience against defined segments. ## Use Cases ### Launching a new product line segment A Product Manager needs to launch 'Alpha Users' but hasn't created the list yet. They tell their agent: 'Create a mailing list called Alpha Users.' The agent uses `create_acelle_list` and confirms it, allowing the PM to immediately start adding test subscribers via `add_acelle_subscriber`. ### Investigating campaign performance failure A Marketing Specialist notices low open rates. They ask their agent to use `list_acelle_campaigns`, find the ID for last month's push, and then run `get_acelle_campaign` to pull detailed status metrics instantly. ### Cleaning up old contacts The Customer Success Team needs a roster of all subscribers in their main list. They prompt the agent with 'List all subscribers for Main List,' which executes `list_acelle_subscribers` and provides the clean data set needed for export. ### Quick audience verification A Campaign Manager wants to know if their two new segments (Beta Testers, VIPs) are properly defined. They ask the agent to run `get_acelle_list` on both names, getting immediate confirmation of configuration metadata for planning. ## Benefits - Instead of manually checking every list, use `list_acelle_lists` to get a full inventory of all directories in seconds. You see everything at once. - Need a new segment? Run the `create_acelle_list` tool and instantly set up a dedicated directory for beta users without leaving your agent chat. - Track outreach progress with confidence. The MCP lets you list campaigns or get campaign details, so you always know if an email is sending, failed, or complete. - Growing your audience is simple. Use `add_acelle_subscriber` to onboard new contacts instantly and verify they are placed in the correct segment. - Auditing your reach is easy. You can run `list_acelle_subscribers` on any list to see exactly who belongs there, confirming your total active count. ## How It Works The bottom line is you get full control over your email marketing operations using simple chat commands, bypassing complex UIs entirely. 1. Subscribe to this MCP and provide your Acelle Mail API Token and Base URL. 2. Your AI client uses natural language prompts to call specific tools, like listing all campaigns or creating a new list. 3. The system executes the command against your Acelle account and returns structured data (e.g., subscriber counts or campaign status) to your agent. ## Frequently Asked Questions **How do I use `add_acelle_subscriber` with Acelle Mail?** You tell your agent: 'Add test@example.com to the Main Newsletter list.' The agent handles the API call, confirming the subscriber was added successfully and immediately. **What is the difference between `list_acelle_lists` and `get_acelle_list`?** `list_acelle_lists` gives you an overview of every list name. You use `get_acelle_list` when you need deep configuration metadata for a single, specific list. **Can I check campaign status using the `get_acelle_campaign` tool?** Yep. Just give your agent the Campaign UID and ask it to run `get_acelle_campaign`. It pulls all the status details—like open rates or sending progress—right away. **Does this MCP help with list segmentation?** It helps by letting you create new segments via `create_acelle_list`, and then verifying who is in those segments using `list_acelle_subscribers`. **Before I use `add_acelle_subscriber`, what is the proper workflow for creating a new list?** You must call `create_acelle_list` first. This tool establishes the directory itself, giving you the necessary identifier (ID) to target. Once that ID exists, your AI client can safely use other tools like `add_acelle_subscriber` or `get_acelle_list` against it. **If I need a high-level overview of all my outreach efforts, what does `list_acelle_campaigns` provide?** It gives you a summary manifest of every campaign, past and present. Instead of diving into one report at a time, this tool lists the crucial metadata for all campaigns, letting you quickly see their status and unique IDs across your entire account. **When I use `list_acelle_subscribers`, does it pull every member, or is there a limit to the data?** It retrieves a comprehensive list of subscribers for the specified directory. If you have an extremely large number of members, your AI client will handle pagination by requesting subsequent pages until all records are processed and returned. **What specific configuration details can I retrieve when I use `get_acelle_list`?** This tool provides the deep metadata you need to manage list settings. You'll get detailed information about the list's current state, including its owner, creation date, and unique organizational properties. **Can I see all the subscribers in a specific list via AI?** Yes! Use the `list_acelle_subscribers` tool and provide the List UID. Your agent will retrieve the directory of members associated with that mailing list. **How do I add a new subscriber to a list using the agent?** Use the `add_acelle_subscriber` action. Provide a JSON object with the subscriber's details, including 'EMAIL' and the target 'list_uid'. The agent will instantly register the new member. **Is it possible to check the status of my email campaigns via AI?** Absolutely. Use the `list_acelle_campaigns` query. The agent will retrieve all your active and past campaigns, allowing you to monitor their delivery status and performance metrics.