mailchimp_list_members
Pack: mailchimp · Endpoint: https://gateway.pipeworx.io/mailchimp/mcp
Get subscribers in an audience by ID (e.g., “abc123def456”). Returns email addresses, subscription status, and custom merge fields.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | Mailchimp API key |
list_id | string | yes | Audience/list ID |
count | number | no | Number of members to return (default 10, max 1000) |
offset | number | no | Offset for pagination (default 0) |
status | string | no | Filter by status: subscribed, unsubscribed, cleaned, pending, transactional |
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_list_members","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_list_members', {
"_apiKey": "your-mailchimp-api-key",
"list_id": "abc123def456"
});More examples
{
"_apiKey": "your-mailchimp-api-key",
"list_id": "abc123def456",
"status": "subscribed",
"count": 100
}Response shape
| Field | Type | Description |
|---|---|---|
members | array | Array of audience members |
list_id | string | Associated audience/list ID |
total_items | number | Total number of members |
_links | array | HAL links |
Full JSON Schema
{
"type": "object",
"properties": {
"members": {
"type": "array",
"description": "Array of audience members",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Member ID"
},
"email_address": {
"type": "string",
"description": "Email address"
},
"unique_email_id": {
"type": "string",
"description": "Unique email ID"
},
"email_type": {
"type": "string",
"description": "Email type (html or text)"
},
"status": {
"type": "string",
"enum": [
"subscribed",
"unsubscribed",
"cleaned",
"pending",
"transactional"
],
"description": "Subscription status"
},
"merge_fields": {
"type": "object",
"description": "Custom merge field values"
},
"interests": {
"type": "object",
"description": "Interest category selections"
},
"stats": {
"type": "object",
"description": "Member engagement stats",
"properties": {
"avg_open_rate": {
"type": "number",
"description": "Average open rate"
},
"avg_click_rate": {
"type": "number",
"description": "Average click rate"
}
}
},
"ip_signup": {
"type": "string",
"description": "IP address signup came from"
},
"timestamp_signup": {
"type": "string",
"description": "Signup timestamp ISO date"
},
"ip_opt": {
"type": "string",
"description": "IP address for last opt-in"
},
"timestamp_opt": {
"type": "string",
"description": "Last opt-in timestamp ISO date"
},
"member_rating": {
"type": "number",
"description": "Member engagement rating"
},
"last_changed": {
"type": "string",
"description": "Last changed timestamp ISO date"
},
"language": {
"type": "string",
"description": "Language preference"
},
"vip": {
"type": "boolean",
"description": "VIP member flag"
},
"email_client": {
"type": "string",
"description": "Email client used"
},
"location": {
"type": "object",
"description": "Location data"
},
"last_note": {
"type": "object",
"description": "Last note on member"
},
"_links": {
"type": "array",
"description": "HAL links"
}
}
}
},
"list_id": {
"type": "string",
"description": "Associated audience/list ID"
},
"total_items": {
"type": "number",
"description": "Total number of members"
},
"_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.