`mailchimp_list_members`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/mailchimp_list_members for the schema, then POST the same URL with its arguments for the data.

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.

mailchimp_list_members