list_automation_subscribers

Retrieve subscribers currently in an automation email queue to monitor campaign progress and audience engagement.

Instructions

List subscribers in an automation email queue

Input Schema

TableJSON Schema

Name	Required	Description	Default
`workflow_id`	Yes	The workflow ID of the automation
`email_id`	Yes	The email ID within the automation

Implementation Reference

src/services/mailchimp.ts:131-140 (handler)

Core handler function in MailchimpService that fetches subscribers from the automation email queue using paginated Mailchimp API request.

async listAutomationSubscribers(
  workflowId: string,
  emailId: string
): Promise<{ subscribers: MailchimpAutomationSubscriber[] }> {
  return await this.makePaginatedRequest(
    `/automations/${workflowId}/emails/${emailId}/queue`,
    "timestamp_signup",
    "DESC"
  );
}

src/tools/index.ts:615-635 (handler)

Tool execution handler in handleToolCall that invokes the service method and formats the subscriber list response as JSON.

case "list_automation_subscribers":
  const subscribers = await service.listAutomationSubscribers(
    args.workflow_id,
    args.email_id
  );
  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(
          subscribers.subscribers.map((s) => ({
            email_address: s.email_address,
            status: s.status,
            merge_fields: s.merge_fields,
          })),
          null,
          2
        ),
      },
    ],
  };

src/tools/index.ts:59-76 (registration)

Tool registration in getToolDefinitions array, including name, description, and input schema for validation.

{
  name: "list_automation_subscribers",
  description: "List subscribers in an automation email queue",
  inputSchema: {
    type: "object",
    properties: {
      workflow_id: {
        type: "string",
        description: "The workflow ID of the automation",
      },
      email_id: {
        type: "string",
        description: "The email ID within the automation",
      },
    },
    required: ["workflow_id", "email_id"],
  },
},

src/tools/index.ts:62-74 (schema)

Input schema definition specifying required workflow_id and email_id parameters.

inputSchema: {
  type: "object",
  properties: {
    workflow_id: {
      type: "string",
      description: "The workflow ID of the automation",
    },
    email_id: {
      type: "string",
      description: "The email ID within the automation",
    },
  },
  required: ["workflow_id", "email_id"],

Mailchimp MCP Server