# EasySendy MCP MCP > EasySendy handles high-volume email list management and campaign prep. Connect your AI agent to manage subscribers, clean up lists, and build segment profiles without leaving your chat window. It gives you full conversational control over adding new users, updating existing records, and ensuring compliance for massive outreach efforts. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** easysendy, email-marketing, subscribers-api, lists-management, marketing-automation, batch-import, engagement-tracking, mcp ## Description Stop building complicated spreadsheets just to update a few names or check who hasn't opened an email in months. This MCP connects your AI agent directly into the backend of EasySendy, letting you manage your entire subscriber lifecycle through natural conversation. You can ask your agent to find all users tagged as 'High Value' and then tell it to add them to a new campaign list—all without logging into a dashboard. When Vinkius hosts this MCP, your AI acts like an expert marketing operations specialist that never sleeps. It’s about getting granular control: you can check custom fields, manage opt-in types, or even delete entire lists if they're obsolete. It treats your mailing list like a living database, letting you keep your audience clean and ready for the next big send. ## Tools ### add_multiple_subscribers Adds several users to one list at the same time using an array of subscriber objects. ### add_subscriber Places a single user into a specific list, requiring both the list ID and email address. ### create_list Sets up an entirely new subscriber group within your EasySendy account. ### delete_list Permanently removes a specific, existing subscriber list. ### delete_subscriber Removes one user from their current list membership. ### get_list_fields Retrieves all custom tags and fields associated with a specific subscriber list. ### get_subscriber_details Pulls the full profile information for any single user in your database. ### list_all_lists Provides a list of every subscriber group currently held in your account. ### unsubscribe_user Removes a user from a mailing list, marking them as opted out. ### update_list Makes changes to the settings or name of an already existing subscriber group. ### update_subscriber Modifies specific details (like name or status) for a user within a list. ## Prompt Examples **Prompt:** ``` List all my email subscriber lists in EasySendy. ``` **Response:** ``` I've retrieved your email lists. You currently have 3 active lists: 'Newsletter 2026' (UID: abc-123), 'Product Leads', and 'Beta Testers'. Which one should we manage? ``` **Prompt:** ``` Add subscriber 'john.doe@example.com' to list UID 'abc-123'. ``` **Response:** ``` Done! John Doe has been successfully added to the 'Newsletter 2026' list. They will now receive your scheduled campaigns for this list. ``` **Prompt:** ``` Find subscriber details for 'sarah@example.com' in list 'abc-123'. ``` **Response:** ``` I've located Sarah's profile in the specified list. She is currently 'Confirmed' and joined on 2024-03-15. Her tags include 'Premium' and 'Loyalty'. Would you like to see her custom field values? ``` ## Capabilities ### Create and structure new email lists You can make entirely new subscriber groups or modify existing ones to fit a specific campaign goal. ### Manage individual subscriber records Find a person's profile, check their details, or update basic information like their name or status. ### Clean and adjust list membership Remove users who unsubscribed, delete inactive accounts, or correct memberships in bulk. ### Batch add multiple subscribers at once Feed the AI a large group of emails and instantly get them added to one or more active lists. ### Check custom list metadata Retrieve all the specific tags, fields, and details attached to any given subscriber list. ## Use Cases ### Cleaning up old lists A manager notices that the '2021 Leads' list is full of inactive people. Instead of manually checking each profile, they ask their agent to run `get_subscriber_details` for a sample and then use `delete_subscriber` on all stale records. The list becomes healthy overnight. ### Onboarding a new partner segment The sales team gets 500 new contacts from a conference. Instead of exporting them to Excel, the marketer uses `add_multiple_subscribers` and tags them immediately with 'Conference Q2' so they can target them later. ### Correcting profile errors A key client changed their job title. The marketing ops engineer runs `update_subscriber` via the agent to fix the record instantly across all lists, ensuring communications are accurate. ## Benefits - Instead of logging into the dashboard to find out what lists you have, just ask the agent to `list_all_lists`. It instantly shows every group you manage. This saves time and eliminates clicking through menus. - Need to onboard a big client list? Use `add_multiple_subscribers` to dump hundreds of contacts at once. Forget manual CSV uploads; it handles the scale in one command. - Running into compliance issues? You can use `unsubscribe_user` or `update_list` to manage opt-in status instantly. This keeps your list clean and protects your sender score. - Want context on a user's history? Run `get_subscriber_details` on any email address to see their full profile, tags, and join date before you write the next campaign. - When you need structured data, `get_list_fields` pulls all custom tags for a list. This lets your agent build hyper-specific segments, making campaigns much more targeted. ## How It Works The bottom line is you get full control over your mailing lists by simply talking to your AI client. 1. First, subscribe to this MCP and grab your Public API Key from your EasySendy dashboard. 2. Next, paste that key into your AI client's settings. Your agent now has direct access to the list management tools. 3. Then, start talking to it. Just ask things like, 'Get me all my active lists,' or 'Add this group of 50 people.' It handles the rest. ## Frequently Asked Questions **How do I see what lists are available with EasySendy MCP using `list_all_lists`?** Running `list_all_lists` instantly gives you every list ID and name in your account. You'll know exactly which group to target for the next campaign. **What is the difference between `add_subscriber` and `add_multiple_subscribers`?** `add_subscriber` handles one person at a time, useful if you're correcting a single record. Use `add_multiple_subscribers` when you have an array of many contacts to add fast. **Can I check what custom fields are available for a list using `get_list_fields`?** Yes, running `get_list_fields` pulls all the specific tags and metadata attached to that particular list. This is key for segmentation. **What should I do if a user has changed their email address? Do I use `update_subscriber`?** You can use `update_subscriber`. It lets you modify specific details for an existing user, like changing their profile information or status. **If I want to remove a user, do I use `delete_subscriber` or `unsubscribe_user`?** `unsubscribe_user` formally removes them from receiving emails. `delete_subscriber` is stronger; it actually deletes the record completely from your database. **What information do I need to provide when using the `create_list` tool?** You must specify a unique name for the list. This function lets you structure your audience data before importing users or running campaigns. It's best practice to add descriptive tags during creation so you can easily segment it later. **When using `add_multiple_subscribers`, how does the system handle errors or skipped records in a large batch?** The tool processes subscribers individually and returns a detailed report. You get clear status codes for every entry, showing exactly which users were added successfully and why any others failed. **If I need to change the name or description of an existing group, how does `update_list` work?** The `update_list` tool allows you to modify the list's metadata without affecting its subscribers. You simply provide the List UID and the new details; it handles the rest. **How do I find my EasySendy API Key?** Log in to your EasySendy account, click on your profile (top right), select **APIs**, and copy your Public API Key. **Can I search for a subscriber by email?** Yes! Use the `get_subscriber_details` tool and provide the List UID and the subscriber's email address to retrieve their full profile. **How do I import multiple subscribers at once?** Use the `add_multiple_subscribers` tool and provide a JSON array containing the subscriber details (EMAIL, FNAME, LNAME, etc.).