Mailchimp

Mailchimp Marketing API v3.0 for audience and campaign data

19 tools available

Installation

Claude Desktop

{
  "mcpServers": {
    "hopkin-mailchimp": {
      "url": "https://mailchimp.mcp.hopkin.ai",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

CLI

npm install -g @hopkin/cli
hopkin auth set-key hpk_live_...
hopkin mailchimp ping

Tools

-accounts

mailchimp_list_accounts List Connected Mailchimp Accounts

Read-onlyIdempotentOpen-world

List all Mailchimp accounts connected for the authenticated user. Returns account IDs, names, data centers, and login emails.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
View full documentation →

-audiences

mailchimp_list_audiences List Mailchimp Audiences

Read-onlyIdempotentOpen-world

List all audiences (lists) in the Mailchimp account with name search and pagination. Returns member count, open rate, click rate, and list rating for each audience.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience (list) ID.
reason requiredstringWhy this tool call is needed
1 optional parameter
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

audience

mailchimp_get_audience Get Mailchimp Audience Details

Read-onlyIdempotentOpen-world

Get detailed information about a specific Mailchimp audience (list), including stats, settings, and campaign defaults.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience (list) ID.
reason requiredstringWhy this tool call is needed
1 optional parameter
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

k-auth-status

mailchimp_check_auth_status Check Mailchimp Authentication Status

Read-onlyIdempotentOpen-world

Troubleshoot authentication issues and get user profile info. Only use when another tool fails with a permission or authentication error — do NOT call proactively.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
View full documentation →

-automations

mailchimp_list_automations List Mailchimp Automations

Read-onlyIdempotentOpen-world

List automations (classic automations / customer journeys) in the Mailchimp account with status filtering, title search, and pagination.

ParameterTypeDescription
automation_id requiredstringThe Mailchimp automation (classic automation / customer journey) ID.
reason requiredstringWhy this tool call is needed
1 optional parameter
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

automation

mailchimp_get_automation Get Mailchimp Automation Details

Read-onlyIdempotentOpen-world

Get detailed information about a specific Mailchimp automation including all associated emails with their delivery stats.

ParameterTypeDescription
automation_id requiredstringThe Mailchimp automation (classic automation / customer journey) ID.
reason requiredstringWhy this tool call is needed
1 optional parameter
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

-campaigns

mailchimp_list_campaigns List Mailchimp Campaigns

Read-onlyIdempotentOpen-world

List campaigns in the Mailchimp account with status filtering, server-side title search, sorting, date range filtering, and pagination. When the search parameter is provided (without a cursor), routes to Mailchimp's /search-campaigns endpoint for accurate server-side matching sorted by most recent send_time — ideal for campaign disambiguation by title. Results include web_id, audience name, and send_time for easy identification. Use sort_field=send_time with sort_dir=DESC to get the most recently sent campaigns first. Use since_send_time/before_send_time to filter by send date window.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
5 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
campaign_idstringThe Mailchimp campaign ID. Required unless web_id is provided.
web_idintegerAlternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence.
include_contentbooleanInclude a preview of the campaign HTML/text content (truncated to 5000 chars).
include_send_checklistbooleanInclude the send checklist for the campaign.
View full documentation →

campaign

mailchimp_get_campaign Get Mailchimp Campaign Details

Read-onlyIdempotentOpen-world

Get detailed information about a specific Mailchimp campaign. Optionally includes content preview (text/HTML, truncated) and send checklist.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
5 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
campaign_idstringThe Mailchimp campaign ID. Required unless web_id is provided.
web_idintegerAlternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence.
include_contentbooleanInclude a preview of the campaign HTML/text content (truncated to 5000 chars).
include_send_checklistbooleanInclude the send checklist for the campaign.
View full documentation →

Uncategorized

mailchimp_ping Ping Mailchimp MCP Server

Read-onlyIdempotent

Health check for the Mailchimp MCP server. Does not call the Mailchimp API.

ParameterTypeDescription
entity_type requiredstringType of ad entity: ad_account, campaign, ad_set, or ad
entity_id requiredstringThe platform entity ID
key requiredstringThe preference key to delete
reason requiredstringWhy this tool call is needed
View full documentation →

preferences

mailchimp_get_preferences Get Mailchimp Preferences

Read-onlyIdempotent

Get all stored preferences for a Mailchimp entity. Preferences are also automatically attached to entity-listing responses, so you often don't need to call this explicitly.

ParameterTypeDescription
entity_type requiredstringType of ad entity: ad_account, campaign, ad_set, or ad
entity_id requiredstringThe platform entity ID
key requiredstringThe preference key to delete
reason requiredstringWhy this tool call is needed
View full documentation →

campaign-report

mailchimp_get_campaign_report Get Mailchimp Campaign Report

Read-onlyIdempotentOpen-world

Get a detailed performance report for a sent Mailchimp campaign, including opens, clicks, bounces, forwards, ecommerce, delivery status, and industry comparison stats.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience/list ID.
reason requiredstringWhy this tool call is needed
5 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_growth_historyboolean
include_activityboolean
include_clientsboolean
include_locationsboolean
View full documentation →

audience-insights

mailchimp_get_audience_insights Get Mailchimp Audience Insights

Read-onlyIdempotentOpen-world

Get insights for a Mailchimp audience including growth history, activity, email clients, and geographic locations. Each data source is fetched in parallel and degrades gracefully on failure.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience/list ID.
reason requiredstringWhy this tool call is needed
5 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_growth_historyboolean
include_activityboolean
include_clientsboolean
include_locationsboolean
View full documentation →

email-activity

mailchimp_get_email_activity Get Mailchimp Email Activity

Read-onlyIdempotentOpen-world

Get email activity (opens, clicks, bounces) for individual recipients of a sent Mailchimp campaign. Supports pagination.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience/list ID.
reason requiredstringWhy this tool call is needed
5 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_growth_historyboolean
include_activityboolean
include_clientsboolean
include_locationsboolean
View full documentation →

ab-test-report

mailchimp_get_ab_test_report Get Mailchimp A/B Test or Multivariate Report

Read-onlyIdempotentOpen-world

Get per-variant performance data for an A/B split or multivariate campaign test. Returns variant-level metrics including opens, clicks, bounces, ecommerce, and winner status. Each variant includes a test_type field (subject_line, from_name, content, send_time, multivariate, unknown) and a changed_dimensions object with structured variant definition data (subject_line, from_name, reply_to, content_label, send_time_variant). Ecommerce data includes currency and an ecommerce_data_complete flag indicating whether all variants have data. Works for both A/B split (2 variants) and multivariate (multiple combinations) campaigns. Use mailchimp_list_campaigns with type filter ["absplit", "variate"] to find testable campaigns.

ParameterTypeDescription
campaign_id requiredstringThe Mailchimp campaign ID. Must be an A/B split or multivariate campaign.
reason requiredstringWhy this tool call is needed
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_ecommercebooleanInclude per-variant ecommerce data (orders, revenue). Only available if ecommerce tracking is enabled.
View full documentation →

-segments

mailchimp_list_segments List Mailchimp Segments

Read-onlyIdempotentOpen-world

List segments for a Mailchimp audience with optional type filtering and pagination. Segment types include saved, static, and fuzzy.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience/list ID.
reason requiredstringWhy this tool call is needed
4 optional parameters
ParameterTypeDescription
typestringFilter by segment type.
limitinteger
cursorstring
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

-subscribers

mailchimp_list_subscribers List Mailchimp Subscribers

Read-onlyIdempotentOpen-world

List subscribers (members) of a Mailchimp audience with status filtering, email search, and pagination. Requires an audience_id. Use search to find specific subscribers by email or name.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience (list) ID.
email_or_hash requiredstringEmail address or MD5 subscriber hash.
reason requiredstringWhy this tool call is needed
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_activitybooleanInclude recent activity feed for this subscriber.
View full documentation →

subscriber

mailchimp_get_subscriber Get Mailchimp Subscriber Details

Read-onlyIdempotentOpen-world

Get detailed information about a specific subscriber by email address or MD5 hash. Optionally includes recent activity feed.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience (list) ID.
email_or_hash requiredstringEmail address or MD5 subscriber hash.
reason requiredstringWhy this tool call is needed
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
include_activitybooleanInclude recent activity feed for this subscriber.
View full documentation →

-tags

mailchimp_list_tags List Mailchimp Tags

Read-onlyIdempotentOpen-world

List tags for a Mailchimp audience with pagination. Tags are user-defined labels applied to subscribers for organization and segmentation.

ParameterTypeDescription
audience_id requiredstringThe Mailchimp audience/list ID.
reason requiredstringWhy this tool call is needed
3 optional parameters
ParameterTypeDescription
limitinteger
cursorstring
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
View full documentation →

-templates

mailchimp_list_templates List Mailchimp Templates

Read-onlyIdempotentOpen-world

List email templates in the Mailchimp account with type filtering, name search, and pagination. Filter by type (user, base, gallery) to narrow results.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
6 optional parameters
ParameterTypeDescription
limitintegerMaximum number of results to return (1–100). Default: 20.
cursorstringOpaque pagination cursor from a previous response.
refreshbooleanForce a fresh fetch bypassing the cache.
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
searchstringFilter templates by name (case-insensitive substring match).
typestringFilter templates by type.
View full documentation →