mailchimp_list_audiences
Pack: mailchimp · Endpoint: https://gateway.pipeworx.io/mailchimp/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/mailchimp_list_audiences for the schema, then POST the same URL with its arguments for the data.
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.