`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 to list subscribers from.
`--status`	`array`	Optional	Filter by subscription status. E.g. ["subscribed", "unsubscribed"].
`--search`	`string`	Optional	Search subscribers by email address or name. Uses the Mailchimp search-members endpoint.
`--limit`	`integer`	Optional	Maximum number of results to return (1-100). Default: 20.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`--connection-id`	`string`	Optional	Optional 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.

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

Parameters

Name	Type	Required	Description
`audience_id`	`string`	Required	The Mailchimp audience (list) ID to list subscribers from.
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

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.
`status`	`array`	Optional	Filter by subscription status. E.g. ["subscribed", "unsubscribed"].
`search`	`string`	Optional	Search subscribers by email address or name. Uses the Mailchimp search-members endpoint.
`limit`	`integer`	Optional	Maximum number of results to return (1-100). Default: 20.min: 1, max: 100
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`connection_id`	`string`	Optional	Optional 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.

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