`mailchimp_list_subscribers`

List Mailchimp Subscribers

Mailchimp

Description

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.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mailchimp_list_subscribers",
    "arguments": {
      "audience_id": "abc123",
      "reason": "List subscribers"
    }
  }
}

hopkin mailchimp -subscribers

Flag	Type	Required	Description
`--account`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`--audience-id`	`string`	Required	The Mailchimp audience (list) ID.
`--email-or-hash`	`string`	Required	Email address or MD5 subscriber hash.
`--include-activity`	`boolean`	Optional	Include recent activity feed for this subscriber.

{
  "mcpServers": {
    "mailchimp": {
      "url": "https://mailchimp.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`audience_id`	`string`	Required	The Mailchimp audience (list) ID.
`email_or_hash`	`string`	Required	Email address or MD5 subscriber hash.
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (2)

Name	Type	Required	Description
`account_id`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`include_activity`	`boolean`	Optional	Include recent activity feed for this subscriber.

Examples

List all

{
  "audience_id": "abc123",
  "reason": "List subscribers"
}

hopkin mailchimp -subscribers --audience-id abc123

Filter by status

{
  "audience_id": "abc123",
  "status": [
    "subscribed"
  ],
  "reason": "List active subscribers"
}

hopkin mailchimp -subscribers --audience-id abc123 --status subscribed

Search

{
  "audience_id": "abc123",
  "search": "john@example.com",
  "reason": "Find a subscriber"
}

hopkin mailchimp -subscribers --audience-id abc123 --search john@example.com