`mailchimp_list_audiences`

List Mailchimp Audiences

Mailchimp

Description

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.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mailchimp_list_audiences",
    "arguments": {
      "reason": "List all audiences"
    }
  }
}

hopkin mailchimp -audiences

Flag	Type	Required	Description
`--limit`	`integer`	Optional	Maximum number of results to return (1–100). Default: 20.
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response.
`--refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`--account`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`--search`	`string`	Optional	Filter audiences by name (case-insensitive substring match).
`--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
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`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.
`refresh`	`boolean`	Optional	Force a fresh fetch bypassing the cache.
`account_id`	`string`	Optional	Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts.
`search`	`string`	Optional	Filter audiences by name (case-insensitive substring match).
`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

{
  "reason": "List all audiences"
}

hopkin mailchimp -audiences

Search

{
  "search": "Newsletter",
  "reason": "Find newsletter audiences"
}

hopkin mailchimp -audiences --search Newsletter

Force refresh

{
  "refresh": true,
  "reason": "Get fresh audience data"
}

hopkin mailchimp -audiences --refresh true