# Maildroppa MCP > Maildroppa connects your email marketing to your agent. Use AI conversation to manage entire campaigns—creating segments, adding tags, updating user data, and monitoring analytics without touching a dashboard. It's for solopreneurs who need to grow their list and run targeted drip campaigns quickly. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** email-campaigns, subscriber-management, drip-campaigns, email-analytics, newsletter ## Description Look, this isn't some fancy dashboard you gotta click through. This server lets your AI client manage every damn thing in Maildroppa just by talking to it. You connect your actual account and treat the whole platform like a set of tools you call out—no touching any UI is necessary. **Adding and Updating Subscribers** You can onboard a brand-new user directly using `create_subscriber`, which builds their full profile with initial contact details. When an existing subscriber changes their core info, use `update_subscriber` to overwrite data like their email or name entirely. If you only need to adjust one piece of information—say, just changing their job title—you use the specific tool, `update_subscriber_field`, leaving all other data untouched. **Segmenting and Tagging Users** To keep your campaigns targeted, it lets you build new, specific user groups using `create_segment` based on criteria you set. You can review every existing segment through `list_segments`. For precise filtering later on, the agent uses `add_tag_to_subscriber` to apply one or more tags to any single profile by ID. Before tagging someone, you'll want to define a totally new type of label with `create_tag`, and you can see all existing tag types using `list_tags`. **Managing User Data and Auditing the List** You need full visibility into your data before you change anything. You retrieve everything about any user—all their current info and custom fields—by running `get_subscriber_details` on a specific ID. For a massive overview, `list_subscribers` pulls a paginated list of every active subscriber, letting you filter the results using provided parameters. To know what data points are even available for mapping or updating, use `list_custom_fields` to see every custom field type currently running on the platform. **Reviewing Platform Structure and Forms** You gotta audit everything before you make changes. Run `list_sign_up_forms` to get a list of every active form capturing new sign-ups from your website. If you need to know what segments are already established, run `list_segments`; if you want to see all the tag types available for use across your base, check `list_tags`. You can also review what custom fields exist on the platform using `list_custom_fields`. **How It Works** When you activate this server, your AI client calls specific functions—like asking it to run `create_segment` or `get_subscriber_details`—and passes in parameters like segment names or user IDs. Maildroppa processes that request, updates the actual backend list, and sends back confirmation data straight to your agent. ## Tools ### add_tag_to_subscriber Applies one or more tags to an existing subscriber profile using their ID. ### create_segment Builds and saves a new, specific group of subscribers based on defined criteria. ### create_subscriber Adds a brand-new person to the mailing list with initial contact details. ### create_tag Defines an entirely new type of tag that can be used across the entire subscriber base. ### get_subscriber_details Retrieves all current information and custom fields for a specific user by ID. ### list_custom_fields Shows every type of custom field currently available on the platform for data mapping. ### list_sign_up_forms Shows a list of every active form used to capture new sign-ups on your website. ### list_segments Lists all existing subscriber segments so you can review and manage them. ### list_subscribers Retrieves a paginated list of all current subscribers by providing filtering parameters. ### list_tags Lists every existing tag type available for applying to users. ### update_subscriber_field Changes only one specific custom field value for a subscriber, leaving other data intact. ### update_subscriber Overwrites core profile information (like email or name) for an existing user. ## Prompt Examples **Prompt:** ``` Show all campaigns and performance for the latest one. ``` **Response:** ``` Campaigns: 8 total. Latest: 'Spring Product Launch' (sent Apr 24). Recipients: 2,400. Opens: 864 (36% ⭐). Clicks: 216 (9%). Bounces: 12 (0.5%). Unsubscribes: 3 (0.1%). Top link: 'Shop Now' (142 clicks). Others: 'Newsletter #12' (32% open), 'Welcome Series' (auto, 45% open). ``` **Prompt:** ``` Show subscriber lists and create a new segment. ``` **Response:** ``` Lists: 3. 'Main Newsletter' (2,400 subscribers). 'Product Updates' (1,800). 'Beta Testers' (340). Total: 4,540. Growth (30 days): +120. Segment created! 'Engaged Users' — opened 3+ emails in last 30 days: 890 subscribers (37% of Main). Ready for targeting. ``` **Prompt:** ``` Show automation sequences and their conversion rates. ``` **Response:** ``` Automations: 3 active. 'Welcome Series' (5 emails, 45% open, 12% click, 8% conversion ⭐). 'Abandoned Cart' (3 emails, 38% open, 15% click, 6% conversion). 'Re-engagement' (2 emails, 22% open, 5% click). Total triggered (30 days): 890. Revenue attributed: $4,200. ``` ## Capabilities ### Segment Subscribers Create new user groups (segments) based on specific shared characteristics. ### Tag Users Apply predefined labels or tags to single subscribers for easy filtering later. ### Manage User Profiles Get, update, or retrieve specific data fields for any individual subscriber on the list. ### List and Audit Data Review all existing segments, tags, custom fields, and sign-up forms before making changes. ### Add New Subscribers Onboard a new user directly to the list by creating their profile record. ## Use Cases ### The Post-Webinar Followup A user runs a webinar and collects 50 new leads. Instead of manually reviewing their sign-ups, they ask the agent to `create_segment` for 'attendees who opened the follow-up email within 24 hours.' This segment is immediately ready to receive a special product offer. ### Fixing Outdated Data A user realizes their list has old job titles. They ask the agent to `list_custom_fields` first, then use `update_subscriber_field` on 10 high-value contacts to correct their 'Company Size' field from 'Small' to 'Midmarket.' The data is clean before the next campaign. ### Tracking High-Value Leads A sales team identifies a new type of client: 'Executive Buyers.' They use `create_tag` to define this tag, then ask the agent to loop through the top 50 subscribers using `list_subscribers` and apply the new tag via `add_tag_to_subscriber`. ### Initial List Health Check Before launching a major email blast, a user asks the agent to run `list_segments`, then `list_tags`, and finally `list_sign_up_forms`. This instantly provides a full map of how the list is organized and where new leads are coming from. ## Benefits - Segment users instantly. Instead of running a report to find 'users who bought X,' call `create_segment` and tell the agent the criteria. The segment appears ready for targeting. - Avoid data drift. You don't have to remember which fields are available; use `list_custom_fields` first, then use `update_subscriber_field` to change a single user’s specific job title or industry field. - Track new users efficiently. When a sign-up happens, call `add_tag_to_subscriber` immediately with the tag 'Source: Blog' so you know exactly where that lead came from for reporting. - Audit your list status without clicking anything. Use `list_subscribers` to get an immediate count and filter by date range or other parameters in a single API call. - Build structured campaigns. If you need to target 'Beta Testers' who are also in the 'Enterprise' segment, combine `create_segment` with specific criteria for maximum accuracy. ## How It Works The bottom line is you talk to your agent, and it handles all the API calls needed within Maildroppa. 1. Provide your Maildroppa API Key and subscribe to the server. 2. Your agent calls a specific tool, like `create_segment`, providing inputs (e.g., 'users who opened 3+ emails'). 3. The server executes the task on Maildroppa's backend and returns confirmation or the resulting data set. ## Frequently Asked Questions **How do I check which tags are available using Maildroppa MCP Server?** You call the `list_tags` tool. This returns every tag type currently set up on your account, so you know what labels you can use with `add_tag_to_subscriber`. **Can I update a subscriber's company size field using Maildroppa MCP Server?** Yes. Use the `update_subscriber_field` tool and pass both the unique Subscriber ID and the name of the custom field, along with the new value. **What is the best way to start a new segment in Maildroppa MCP Server?** First, use `list_custom_fields` so you know what data points are available. Then, tell your agent to run `create_segment`, specifying the exact combination of criteria. **Does Maildroppa MCP Server handle campaign sending?** No. This server manages the *data* (segments, tags, profiles). You must use a separate tool or platform to actually send and track the email campaigns. **When setting up the Maildroppa MCP Server, what credentials do I use for authentication?** You connect using your unique Maildroppa API Key. This key authenticates all calls to the server from your AI client. Never share this key; it gives full access to your mailing list data and capabilities. **How does the Maildroppa MCP Server handle retrieving large volumes of subscriber data?** The system uses standard pagination methods for listing subscribers. If you query a massive list, your agent will receive results in chunks (batches) instead of one huge payload. You'll need to iterate through all pages until the full dataset is processed. **If I need to change basic subscriber details versus specific fields, which tool in Maildroppa MCP Server should I use?** Use `update_subscriber` for general changes—this handles core profile information. If you only want to modify one piece of data, like a job title or industry, stick to `update_subscriber_field`. It's much more precise. **Before creating segments with Maildroppa MCP Server, how do I check what custom fields are available?** Run the `list_custom_fields` tool first. This command shows every type of field your list accepts—things like 'Company Size' or 'Industry.' You need this information to build accurate segment criteria. **Can I create and track email campaigns?** Yes. Create campaigns, send to subscriber segments, and track open rates, click rates, bounces, and unsubscribes in real time. **How does Maildroppa authentication work?** Maildroppa uses a custom **X-API-Key** header (not Bearer) against `api.maildroppa.com`. **Can I manage subscriber lists and segments?** Yes. Create and manage subscriber lists, add/remove subscribers, and build segments with custom conditions.