# Mailchimp MCP > Mailchimp MCP gives your AI agent full programmatic control over your marketing efforts. You can list entire audiences, update subscriber status dynamically, create campaigns, and send live emails without touching the web interface. It lets you manage complex contact lists and track performance metrics autonomously. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** audience-sync, subscriber-management, campaign-tracking, marketing-analytics, contact-lists, email-delivery ## Description Your agent connects directly to Mailchimp's core functions, treating your mailing operations like a clean database query instead of a series of clicks. You can pull detailed stats on specific audiences or check global campaign performance reports just by asking the right questions. Need to adjust who gets an email? Your agent handles that. It adds new contacts with statuses like 'subscribed' or removes old ones entirely, all based on conversation. If you’re building a robust data pipeline for marketing, integrating this MCP through Vinkius lets your AI client manage everything from audience segmentation to final campaign delivery—all from one place. This connection means you can trace complex workflows: listing all available automation sequences, getting the raw details of any campaign draft, and even triggering immediate sends. It's about having granular control over every contact record and every metric without ever logging into the platform. ## Tools ### add_member Adds a new contact to any Mailchimp audience, specifying their status (e.g., subscribed or pending). ### list_audiences Retrieves a list of all your mailing audiences, including their IDs and current member counts. ### list_automations Shows every automation workflow currently set up within the Mailchimp account. ### list_campaigns Lists all saved campaigns, giving you IDs and basic stats like subject lines and send times. ### create_campaign Generates a brand new campaign draft within Mailchimp and returns its unique ID for later use. ### delete_member Archives or removes an existing subscriber from an audience using their list ID and MD5 hash. ### get_audience Fetches deep configuration details for a specific audience, including member count and open/click rate baselines. ### get_campaign Retrieves the full metadata and detailed status of any existing Mailchimp campaign. ### list_members Lists all contacts within a specified audience, showing their emails, current status, and tags. ### get_report Generates and retrieves the full performance report for a specific campaign run. ### search_members Searches your entire contact base across all audiences using just a name or email address. ### list_segments Retrieves a list of saved, pre-defined segments for a particular audience. ### send_campaign Triggers an immediate live email send for a campaign; this action cannot be undone. ### update_member Modifies subscriber information, including their status or custom tags, within an audience. ## Prompt Examples **Prompt:** ``` Fetch the ID of my primary audience list. ``` **Response:** ``` Query complete. Your main audience 'Weekly Newsletter' uses the List ID 'a1b2c3d4e5'. You can now use this ID to fetch subscribers. ``` **Prompt:** ``` Add exactly test@domain.com as a subscriber to list a1b2c3d4e5. ``` **Response:** ``` Added subscriber successfully! The contact test@domain.com is now fully mapped as 'subscribed' against that specific audience ID. ``` **Prompt:** ``` List all active marketing campaigns we have on the server. ``` **Response:** ``` I've fetched 3 campaign items. 'Summer Sale 2026' (Sent), 'Welcome Series' (Draft), and 'Churn Automation' (Sent). Would you like to inspect CTR metrics for the sent ones? ``` ## Capabilities ### Manage audience lists List all available mailing audiences and retrieve detailed statistics for any specific list. ### Control subscriber records Add, update, or remove individual contacts from your audience, assigning specific statuses like subscribed or pending. ### Run campaign operations Create new email campaigns, list existing drafts and sent messages, and trigger immediate live sends. ### Analyze performance data Pull comprehensive reports on past campaigns, including open rates and click-through statistics. ### Search and locate contacts Find specific subscribers across all your different lists using their name or email address. ## Use Cases ### The Membership Status Cleanup A Marketing Ops Specialist finds a segment of old users who haven't interacted in months. The agent runs `list_members` on the audience, identifies those inactive records, and then uses `update_member` to change their status to 'pending' for re-engagement campaigns. ### Post-Launch Performance Audit A Digital Analyst needs a full accounting of last month’s email activity. They ask the agent to run `list_campaigns` first, then select the specific campaign ID, and finally call `get_report` to pull all necessary metrics in one go. ### Handling New Signups A Growth Manager integrates a new lead source. Instead of manually adding each person, the agent accepts the contact list and uses `add_member` for every entry, automatically setting their status to 'subscribed' in the correct audience. ### Audience Troubleshooting A Content Marketer notices a campaign is failing. They ask the agent to first run `get_campaign` to check the draft details and then use `list_audiences` to confirm they are targeting the correct primary list ID. ## Benefits - Automate member updates: Instead of manually changing statuses, you can update a member's record with `update_member` based on custom logic or source data. - Comprehensive reporting: Get full campaign performance metrics instantly using the `get_report` tool. This replaces digging through multiple web dashboards to find CTRs and open rates. - Audience segmentation control: You can use `list_audiences` and then narrow down your focus by listing specific segments with `list_segments`, ensuring you only target relevant groups. - Full lifecycle management: From drafting a campaign using `create_campaign` to sending it live via `send_campaign`, the entire process is managed conversationally, eliminating platform switching. - Bulk data handling: Need to revalidate thousands of contacts? You can list all members with `list_members` and pull that raw data for external processing without manual export/import. ## How It Works The bottom line is you give your agent permission and credentials; everything else—the querying and execution—is handled automatically through conversation. 1. Enable the MCP connection under your local profile to grant access. 2. Input an API token generated specifically for your Mailchimp account. 3. Engage with your AI client using natural language prompts, letting it manage the required data flow and operations. ## Frequently Asked Questions **How do I list my audience IDs with Mailchimp MCP?** You use the `list_audiences` tool. This function returns a comprehensive list of all your mailing audiences, along with their unique IDs and current member counts. **Can I send an email without creating a draft first using Mailchimp MCP?** No. You must use `create_campaign` to generate the campaign ID first. Then you can retrieve its details with `get_campaign` before calling `send_campaign`. **How do I find a specific subscriber's email address using Mailchimp MCP?** Use the `search_members` tool. This function searches your entire contact base across all audiences by either name or email, giving you immediate results. **What does `list_campaigns` show me about my marketing efforts?** `list_campaigns` shows the IDs and basic metadata for every campaign. You'll see the subject line, general type, and whether it was sent or is still a draft. **Can I only update member statuses with Mailchimp MCP?** No. The `update_member` tool lets you pass JSON bodies to change more than just status; you can modify custom tags and other merge fields too.