Mailchimp

Mailchimp Marketing API v3.0 for audience and campaign data

24 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
1 optional parameter
ParameterTypeDescription
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
1 optional parameter
ParameterTypeDescription
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
2 optional parameters
ParameterTypeDescription
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
6 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
6 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
View full documentation →

-connections

mailchimp_list_connections List Mailchimp Connections

Read-onlyIdempotent

List the Mailchimp connections available to you — both ones you own and ones shared with you via an organization. Use this to discover connection IDs for set_default / share / rename / revoke.

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

default-connection

mailchimp_set_default_connection Set Default Mailchimp Connection

Read-onlyIdempotent

Set the Mailchimp connection that should be used by default for subsequent Mailchimp tool calls. The default is scoped to the calling actor (your user account, or the API key being used).

ParameterTypeDescription
connection_id requiredstringUUID of the connection to mark as the actor's default Mailchimp connection.
reason requiredstringWhy this tool call is needed
View full documentation →

e-connection

mailchimp_share_connection Share Mailchimp Connection With Organization

Idempotent

Share an owned Mailchimp connection with all members of your organization, so teammates can use it without having to reconnect Mailchimp themselves. You must be the owner of the connection.

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

are-connection

mailchimp_unshare_connection Unshare Mailchimp Connection From Organization

DestructiveIdempotent

Stop sharing an owned Mailchimp connection with your organization. Teammates lose access immediately. You must be the owner.

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

me-connection

mailchimp_rename_connection Rename Mailchimp Connection

Idempotent

Rename the display name of an owned Mailchimp connection. The OAuth grant and underlying account are unaffected — this only changes the human-readable label. You must be the owner.

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

ke-connection

mailchimp_revoke_connection Revoke Mailchimp Connection

DestructiveIdempotent

Revoke (soft-delete) an owned Mailchimp connection. Any defaults pointing to it are invalidated and shared org members lose access. The OAuth grant at Mailchimp is NOT revoked by this tool — the user must disconnect via the dashboard if they want to fully revoke at Mailchimp. You must be the owner.

ParameterTypeDescription
reason requiredstringWhy this tool call is needed
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
feedback_type requiredstringFeedback category: new_tool (request new capability), improvement (enhance existing tool), bug (report issue), workflow_gap (missing workflow)
title requiredstringConcise title summarizing the feedback
description requiredstringWhat is needed and why
reason requiredstringWhy this tool call is needed
3 optional parameters
ParameterTypeDescription
current_workaroundstringCurrent workaround, if any
prioritystringImpact level: low (nice-to-have), medium (improves workflow), high (blocking issue)
interfacestringInterface the feedback originated from: MCP (default) or CLI
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
6 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
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
6 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
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
6 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
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
3 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
5 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
3 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
3 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
4 optional parameters
ParameterTypeDescription
limitinteger
cursorstring
account_idstringMailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
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
7 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.
connection_idstringOptional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.
View full documentation →