mailchimp_list_audiences
Pack: mailchimp · Endpoint: https://gateway.pipeworx.io/mailchimp/mcp
View all audiences in your account. Returns audience names, member counts, and engagement stats. Use mailchimp_get_audience for detailed settings.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | Mailchimp API key (ends with -dc, e.g., abc123-us21) |
count | number | no | Number of audiences to return (default 10, max 1000) |
offset | number | no | Offset for pagination (default 0) |
Example call
Arguments
{
"_apiKey": "your-mailchimp-api-key"
}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_list_audiences","arguments":{"_apiKey":"your-mailchimp-api-key"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('mailchimp_list_audiences', {
"_apiKey": "your-mailchimp-api-key"
});More examples
{
"_apiKey": "your-mailchimp-api-key",
"count": 50,
"offset": 0
}Response shape
| Field | Type | Description |
|---|---|---|
lists | array | Array of audiences |
total_items | number | Total number of audiences |
constraints | object | API constraints |
_links | array | HAL links |
Full JSON Schema
{
"type": "object",
"properties": {
"lists": {
"type": "array",
"description": "Array of audiences",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Audience/list ID"
},
"name": {
"type": "string",
"description": "Audience name"
},
"contact": {
"type": "object",
"description": "Contact information"
},
"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"
},
"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"
}
}
}
},
"total_items": {
"type": "number",
"description": "Total number of audiences"
},
"constraints": {
"type": "object",
"description": "API constraints"
},
"_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.