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
List all Mailchimp accounts connected for the authenticated user. Returns account IDs, names, data centers, and login emails.
| Parameter | Type | Description |
|---|---|---|
reason required | string | Why this tool call is needed |
-audiences
mailchimp_list_audiences List Mailchimp Audiences
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.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience (list) ID. |
reason required | string | Why this tool call is needed |
1 optional parameter
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
audience
mailchimp_get_audience Get Mailchimp Audience Details
Get detailed information about a specific Mailchimp audience (list), including stats, settings, and campaign defaults.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience (list) ID. |
reason required | string | Why this tool call is needed |
1 optional parameter
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
k-auth-status
mailchimp_check_auth_status Check Mailchimp Authentication Status
Troubleshoot authentication issues and get user profile info. Only use when another tool fails with a permission or authentication error — do NOT call proactively.
| Parameter | Type | Description |
|---|---|---|
reason required | string | Why this tool call is needed |
-automations
mailchimp_list_automations List Mailchimp Automations
List automations (classic automations / customer journeys) in the Mailchimp account with status filtering, title search, and pagination.
| Parameter | Type | Description |
|---|---|---|
automation_id required | string | The Mailchimp automation (classic automation / customer journey) ID. |
reason required | string | Why this tool call is needed |
1 optional parameter
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
automation
mailchimp_get_automation Get Mailchimp Automation Details
Get detailed information about a specific Mailchimp automation including all associated emails with their delivery stats.
| Parameter | Type | Description |
|---|---|---|
automation_id required | string | The Mailchimp automation (classic automation / customer journey) ID. |
reason required | string | Why this tool call is needed |
1 optional parameter
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
-campaigns
mailchimp_list_campaigns List Mailchimp Campaigns
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.
| Parameter | Type | Description |
|---|---|---|
reason required | string | Why this tool call is needed |
5 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
campaign_id | string | The Mailchimp campaign ID. Required unless web_id is provided. |
web_id | integer | Alternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence. |
include_content | boolean | Include a preview of the campaign HTML/text content (truncated to 5000 chars). |
include_send_checklist | boolean | Include the send checklist for the campaign. |
campaign
mailchimp_get_campaign Get Mailchimp Campaign Details
Get detailed information about a specific Mailchimp campaign. Optionally includes content preview (text/HTML, truncated) and send checklist.
| Parameter | Type | Description |
|---|---|---|
reason required | string | Why this tool call is needed |
5 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
campaign_id | string | The Mailchimp campaign ID. Required unless web_id is provided. |
web_id | integer | Alternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence. |
include_content | boolean | Include a preview of the campaign HTML/text content (truncated to 5000 chars). |
include_send_checklist | boolean | Include the send checklist for the campaign. |
Uncategorized
mailchimp_ping Ping Mailchimp MCP Server
Health check for the Mailchimp MCP server. Does not call the Mailchimp API.
| Parameter | Type | Description |
|---|---|---|
entity_type required | string | Type of ad entity: ad_account, campaign, ad_set, or ad |
entity_id required | string | The platform entity ID |
key required | string | The preference key to delete |
reason required | string | Why this tool call is needed |
preferences
mailchimp_get_preferences Get Mailchimp Preferences
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.
| Parameter | Type | Description |
|---|---|---|
entity_type required | string | Type of ad entity: ad_account, campaign, ad_set, or ad |
entity_id required | string | The platform entity ID |
key required | string | The preference key to delete |
reason required | string | Why this tool call is needed |
campaign-report
mailchimp_get_campaign_report Get Mailchimp Campaign Report
Get a detailed performance report for a sent Mailchimp campaign, including opens, clicks, bounces, forwards, ecommerce, delivery status, and industry comparison stats.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience/list ID. |
reason required | string | Why this tool call is needed |
5 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_growth_history | boolean | |
include_activity | boolean | |
include_clients | boolean | |
include_locations | boolean |
audience-insights
mailchimp_get_audience_insights Get Mailchimp Audience Insights
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.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience/list ID. |
reason required | string | Why this tool call is needed |
5 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_growth_history | boolean | |
include_activity | boolean | |
include_clients | boolean | |
include_locations | boolean |
email-activity
mailchimp_get_email_activity Get Mailchimp Email Activity
Get email activity (opens, clicks, bounces) for individual recipients of a sent Mailchimp campaign. Supports pagination.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience/list ID. |
reason required | string | Why this tool call is needed |
5 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_growth_history | boolean | |
include_activity | boolean | |
include_clients | boolean | |
include_locations | boolean |
ab-test-report
mailchimp_get_ab_test_report Get Mailchimp A/B Test or Multivariate Report
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.
| Parameter | Type | Description |
|---|---|---|
campaign_id required | string | The Mailchimp campaign ID. Must be an A/B split or multivariate campaign. |
reason required | string | Why this tool call is needed |
2 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_ecommerce | boolean | Include per-variant ecommerce data (orders, revenue). Only available if ecommerce tracking is enabled. |
-segments
mailchimp_list_segments List Mailchimp Segments
List segments for a Mailchimp audience with optional type filtering and pagination. Segment types include saved, static, and fuzzy.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience/list ID. |
reason required | string | Why this tool call is needed |
4 optional parameters
| Parameter | Type | Description |
|---|---|---|
type | string | Filter by segment type. |
limit | integer | |
cursor | string | |
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
-subscribers
mailchimp_list_subscribers List Mailchimp Subscribers
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.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience (list) ID. |
email_or_hash required | string | Email address or MD5 subscriber hash. |
reason required | string | Why this tool call is needed |
2 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_activity | boolean | Include recent activity feed for this subscriber. |
subscriber
mailchimp_get_subscriber Get Mailchimp Subscriber Details
Get detailed information about a specific subscriber by email address or MD5 hash. Optionally includes recent activity feed.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience (list) ID. |
email_or_hash required | string | Email address or MD5 subscriber hash. |
reason required | string | Why this tool call is needed |
2 optional parameters
| Parameter | Type | Description |
|---|---|---|
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
include_activity | boolean | Include recent activity feed for this subscriber. |
-tags
mailchimp_list_tags List Mailchimp Tags
List tags for a Mailchimp audience with pagination. Tags are user-defined labels applied to subscribers for organization and segmentation.
| Parameter | Type | Description |
|---|---|---|
audience_id required | string | The Mailchimp audience/list ID. |
reason required | string | Why this tool call is needed |
3 optional parameters
| Parameter | Type | Description |
|---|---|---|
limit | integer | |
cursor | string | |
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
-templates
mailchimp_list_templates List Mailchimp Templates
List email templates in the Mailchimp account with type filtering, name search, and pagination. Filter by type (user, base, gallery) to narrow results.
| Parameter | Type | Description |
|---|---|---|
reason required | string | Why this tool call is needed |
6 optional parameters
| Parameter | Type | Description |
|---|---|---|
limit | integer | Maximum number of results to return (1–100). Default: 20. |
cursor | string | Opaque pagination cursor from a previous response. |
refresh | boolean | Force a fresh fetch bypassing the cache. |
account_id | string | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
search | string | Filter templates by name (case-insensitive substring match). |
type | string | Filter templates by type. |