`mailchimp_get_audience`

Pack: mailchimp · Endpoint: https://gateway.pipeworx.io/mailchimp/mcp

Get detailed settings and stats for a specific audience. Pass the audience ID (e.g., “abc123def456”). Returns name, member count, engagement metrics, and configuration.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Mailchimp API key
`list_id`	string	yes	Audience/list ID

Example call

Arguments

{
  "_apiKey": "your-mailchimp-api-key",
  "list_id": "abc123def456"
}

curl

curl -X POST https://gateway.pipeworx.io/mailchimp/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mailchimp_get_audience","arguments":{"_apiKey":"your-mailchimp-api-key","list_id":"abc123def456"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('mailchimp_get_audience', {
  "_apiKey": "your-mailchimp-api-key",
  "list_id": "abc123def456"
});

Response shape

Field	Type	Description
`id`	string	Audience/list ID
`name`	string	Audience name
`contact`	object	Contact information
`permission_reminder`	string	Permission reminder text
`use_archive_bar`	boolean	Use archive bar
`campaign_defaults`	object	Default campaign settings
`notify_on_subscribe`	string	Notification email on subscribe
`notify_on_unsubscribe`	string	Notification email on unsubscribe
`date_created`	string	ISO date when audience was created
`list_rating`	number	List rating/reputation score
`email_type_option`	boolean	Email type option enabled
`subscribe_url_short`	string	Short subscribe URL
`subscribe_url_long`	string	Long subscribe URL
`beamer_address`	string	Beamer address
`visibility`	string	Visibility setting
`double_optin`	boolean	Double opt-in enabled
`has_welcome`	boolean	Welcome automation enabled
`marketing_permissions`	boolean	Marketing permissions enabled
`modules`	array	Enabled modules
`stats`	object	Audience statistics
`_links`	array	HAL links

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "name": {
      "type": "string",
      "description": "Audience name"
    },
    "contact": {
      "type": "object",
      "description": "Contact information",
      "properties": {
        "company": {
          "type": "string",
          "description": "Company name"
        },
        "address1": {
          "type": "string",
          "description": "Address line 1"
        },
        "address2": {
          "type": "string",
          "description": "Address line 2"
        },
        "city": {
          "type": "string",
          "description": "City"
        },
        "state": {
          "type": "string",
          "description": "State/province"
        },
        "zip": {
          "type": "string",
          "description": "Postal code"
        },
        "country": {
          "type": "string",
          "description": "Country"
        },
        "phone": {
          "type": "string",
          "description": "Phone number"
        }
      }
    },
    "permission_reminder": {
      "type": "string",
      "description": "Permission reminder text"
    },
    "use_archive_bar": {
      "type": "boolean",
      "description": "Use archive bar"
    },
    "campaign_defaults": {
      "type": "object",
      "description": "Default campaign settings",
      "properties": {
        "from_name": {
          "type": "string",
          "description": "Default from name"
        },
        "from_email": {
          "type": "string",
          "description": "Default from email"
        },
        "subject": {
          "type": "string",
          "description": "Default subject"
        },
        "language": {
          "type": "string",
          "description": "Default language"
        }
      }
    },
    "notify_on_subscribe": {
      "type": "string",
      "description": "Notification email on subscribe"
    },
    "notify_on_unsubscribe": {
      "type": "string",
      "description": "Notification email on unsubscribe"
    },
    "date_created": {
      "type": "string",
      "description": "ISO date when audience was created"
    },
    "list_rating": {
      "type": "number",
      "description": "List rating/reputation score"
    },
    "email_type_option": {
      "type": "boolean",
      "description": "Email type option enabled"
    },
    "subscribe_url_short": {
      "type": "string",
      "description": "Short subscribe URL"
    },
    "subscribe_url_long": {
      "type": "string",
      "description": "Long subscribe URL"
    },
    "beamer_address": {
      "type": "string",
      "description": "Beamer address"
    },
    "visibility": {
      "type": "string",
      "description": "Visibility setting"
    },
    "double_optin": {
      "type": "boolean",
      "description": "Double opt-in enabled"
    },
    "has_welcome": {
      "type": "boolean",
      "description": "Welcome automation enabled"
    },
    "marketing_permissions": {
      "type": "boolean",
      "description": "Marketing permissions enabled"
    },
    "modules": {
      "type": "array",
      "description": "Enabled modules"
    },
    "stats": {
      "type": "object",
      "description": "Audience statistics",
      "properties": {
        "member_count": {
          "type": "number",
          "description": "Total member count"
        },
        "unsubscribe_count": {
          "type": "number",
          "description": "Unsubscribed count"
        },
        "cleaned_count": {
          "type": "number",
          "description": "Cleaned/bounced count"
        },
        "click_rate": {
          "type": "number",
          "description": "Average click rate"
        },
        "avg_sub_rate": {
          "type": "number",
          "description": "Average subscription rate"
        },
        "avg_unsub_rate": {
          "type": "number",
          "description": "Average unsubscription rate"
        },
        "campaign_count": {
          "type": "number",
          "description": "Campaign count"
        },
        "campaign_last_sent": {
          "type": "string",
          "description": "Last campaign send date"
        },
        "merge_field_count": {
          "type": "number",
          "description": "Merge field count"
        },
        "avg_open_rate": {
          "type": "number",
          "description": "Average open rate"
        },
        "total_contacts": {
          "type": "number",
          "description": "Total contacts"
        }
      }
    },
    "_links": {
      "type": "array",
      "description": "HAL links"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "mailchimp": {
      "url": "https://gateway.pipeworx.io/mailchimp/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

mailchimp_get_audience