Intuit Mailchimp

Add ONE existing Mailchimp contact (identified by email) to a STATIC segment inside an audience. Static segments are manually curated lists used for targeting upcoming campaigns; this is how you build them member-by-member. CALL THIS TOOL when the user wants to drop one contact into a specific named segment for targeting: 'add jane@acme.com to the launch-week segment', 'put this contact in the early-access list inside our newsletter audience'. TWO-CALL CONFIRM PATTERN: first call this tool with confirm=false (default) — it returns a preview describing the change without writing anything. Show the user the preview and ask if they want to proceed. Only call again with confirm=true after the user explicitly agrees. REQUIRES A STATIC SEGMENT. Saved/dynamic segments derive their membership from rules; Mailchimp rejects this call for them. If you get a 4xx 'segment is not static' error, the segment can't be written to directly. DO NOT use this to ADD A NEW contact to an audience — that's add_contact_to_audience inside mapi_wrapper. DO NOT use this for tag-based targeting — that's add_or_remove_member_tags. This tool is specifically for named static segments.

add_member_to_segment

Poll a marketing-analytics run previously started with `start-analytics-text`, using the run_id it returned. Returns immediately. While the run is in progress, status is 'pending' or 'streaming' — wait about 10 seconds and call this again. When status is 'complete', the text field holds the finished analysis — present it to the user as-is. When status is 'failed', relay the error. Do NOT invent numbers or answer from your own knowledge while the run is still in progress.

get_analytics_text_status

PRIMARY campaign_planner for Gemini CLI and any non-widget MCP host. Creates a multi-channel campaign plan for the business and returns it as fully self-contained markdown text: per-campaign list with channel, send date, audience, and goal; strategy reasoning; and explicit next-step suggestions the user can act on (refine, save, etc.). The response is the answer — it does NOT reference a widget, carousel, button, or anything the user has to click. Same backend as campaign_planner (creates the plan in Mailchimp's session store, suggests templates, kicks off background enrichment) — only the response shape differs. Use this when the host cannot render UI widgets.

campaign_planner_text

Return RECENT DAILY activity for ONE Mailchimp audience (list) by list_id: per-day emails sent, unique opens, clicks, hard/soft bounces, subscribes, and unsubscribes — an engagement timeline covering recent days. CALL THIS TOOL for audience health, engagement trends over time, and list-level recommendations: 'how is my audience engaging lately', 'show subscriber growth and churn for my list', 'is my newsletter audience healthy', 'recent opens and unsubscribes for this list', 'activity trend for audience abc123'. You need the list_id. If the user names an audience, call search_lists (or list_audiences) first to resolve the id. For a single audience's size and lifetime stats use list_audiences; for one CAMPAIGN's results use get_campaign_stats — this tool is the audience's day-by-day activity.

get_list_activity

Return the METADATA and settings for ONE specific Mailchimp campaign by its campaign_id: subject line, preview text, title, status (sent/draft/scheduled), type, create/send time, from name, reply-to, recipient audience + segment, recipient count, content type, editor, template id, and tracking flags. CALL THIS TOOL when the user wants the details/settings of a single known campaign: 'what's the subject line of campaign abc123', 'when was this campaign sent', 'who was campaign X sent to', 'show me the settings for this campaign', 'what audience did campaign abc123 target'. You need the campaign_id. If the user names a campaign instead of giving an id, call search_campaigns (or list_campaigns) first to resolve the id, then call this. For PERFORMANCE numbers (opens, clicks, bounces, unsubscribes, revenue, orders) use get_campaign_stats instead — this tool is about configuration, not results.

get_campaign

Return the performance report for ONE specific Mailchimp campaign: emails sent, opens (total + unique), open rate, clicks (total + unique), click rate, bounces (hard + soft), unsubscribed count, and e-commerce revenue + orders when tracking is enabled. Accepts either: - campaign_id: the explicit Mailchimp campaign ID (e.g. 'abc123def4') - campaign_name: a partial or full campaign title/subject (e.g. 'Black Friday', 'welcome series') — the tool auto-resolves it to an ID by fuzzy-matching against the user's campaigns. If the name matches multiple campaigns, the tool returns a disambiguation list and asks the user to pick. CALL THIS TOOL for any prompt about ONE specific campaign's performance: 'how did my Black Friday campaign do', 'stats for campaign abc123', 'performance of the welcome email', 'open rate on my last newsletter', 'how many clicks did my X campaign get', 'revenue from the holiday campaign'. If the user asks about campaigns as a whole (no specific one named), use list_campaigns instead. DO NOT route to mapi_wrapper for this — this tool is the dedicated path. Response is markdown text by default; pass output_style for CLI / prose / json variants. structured_content is always populated.

get_campaign_stats

Call this tool for requests involving: automations, workflows, abandoned cart, welcome series, post-purchase, win-back, birthday emails, triggers, contacts, segments, or audience management, or any campaign-building/editing or content-creation request. Also call it whenever the user asks for any functionality not offered by another tool — including requests phrased as 'create', 'set up', 'build', or 'configure'. These areas are out of scope for this integration. Do NOT call this tool for things the dedicated tools handle: marketing analytics or performance questions (use start_analytics_text, then poll get_analytics_text_status), listing or searching campaigns (use list_campaigns / search_campaigns), a single campaign's details or stats (use get_campaign / get_campaign_stats), listing or searching audiences (use list_audiences / search_lists), or audience activity and health (use get_list_activity). Categories: 1. 'mailchimp_only': Exists in the Mailchimp app but not this integration (automations, reports, contact management) 2. 'not_supported': Not available in this integration or Mailchimp (visual reports, dashboards) 3. 'similar_capability': A related feature is available here under a different name (WhatsApp → suggest SMS) The returned text is the integration's authoritative answer for the request: it names what is out of scope, points the user to the correct place (usually the Mailchimp app), and lists the concrete alternatives this integration supports. The alternatives returned are exhaustive for the category — any capability not named in the response is not available in this integration.

get_capabilities

Return the recent activity events for ONE Mailchimp contact (audience member) identified by email + list_id: a chronological event log of sends, opens, clicks, bounces, unsubscribes, signups, ecommerce events, etc. Use this to answer 'what happened with this contact' workflows. CALL THIS TOOL when the user asks about ONE specific person by email: 'what did jane@acme.com do', 'has bob@foo.com opened anything recently', 'why is this contact marked bounced', 'show clicks from alice@example.com'. You need both list_id and the contact's email. If the user only named the audience, call search_lists or list_audiences first to resolve the list_id. DO NOT use this for audience-level questions — use get_list_activity (daily totals across the whole audience) or list_audiences (per-audience identity + lifetime stats). DO NOT use this for campaign-level questions — use get_campaign_stats.

get_list_member_activity

Return the user's Mailchimp account-level context: business name, industry / vertical, account-wide subscriber count, pricing plan, timezone, member-since date, contact location (city / state / country), AND industry-conditioned peer benchmarks (the average open rate, click rate, and bounce rate for OTHER Mailchimp accounts in the same industry). One call to the Mailchimp API root. CALL THIS TOOL for any prompt about who the user is, what their business does, or how their numbers compare to peers: 'what industry am I in', 'tell me about my account', 'what's my business profile', 'how do I compare to similar businesses', 'what's the average open rate for my industry', 'industry benchmarks', 'peer comparison', 'where is my business located'. Also call this when grounding a marketing plan or campaign idea — knowing the user's vertical and peer averages lets you tailor recommendations. DO NOT route to mapi_wrapper for this — this tool is the dedicated path. Response is markdown text by default; pass output_style='plain'/'prose'/'json' for CLI / document-paste / programmatic uses.

get_customer_context

Return the user's Mailchimp audiences (mailing lists) with rich metadata: id, name, member count, total contacts (incl. unsubscribed/cleaned), campaign count, average open / click rate, last campaign sent date, last subscribe date, list rating, double opt-in flag, marketing permissions flag, contact info (company, city/state/country), and the audience's campaign defaults (from name, from email, language). One call, one page of up to 100 audiences. CALL THIS TOOL for any prompt about the user's audiences / mailing lists / contact lists: 'list my audiences', 'what mailing lists do I have', 'show me my contact lists', 'how big are my audiences', 'audience health', or any prompt where the user wants to see multiple audiences at once. Also use as the first step when the user wants to add a contact and hasn't named the audience — list first, then route to add_contact_to_audience on the chosen one. DO NOT route to mapi_wrapper for this — this tool is the dedicated path. Response is markdown text by default; pass output_style='plain'/'prose'/'json' for CLI / document-paste / programmatic uses.

list_audiences