list_automations

Instructions

Implementation Reference

• src/tools/index.ts:548-567 (handler)

  The handler logic within handleToolCall for the 'list_automations' tool. It calls the MailchimpService.listAutomations() method and returns a formatted JSON string of selected automation fields.

  case "list_automations":
    const automations = await service.listAutomations();
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            automations.automations.map((a) => ({
              id: a.id,
              name: a.name,
              status: a.status,
              type: a.type,
              create_time: a.create_time,
            })),
            null,
            2
          ),
        },
      ],
    };

• src/tools/index.ts:4-12 (registration)

  Registration of the 'list_automations' tool in getToolDefinitions array, including name, description, and empty input schema.

  {
    name: "list_automations",
    description: "List all automations in your Mailchimp account",
    inputSchema: {
      type: "object",
      properties: {},
      required: [],
    },
  },

• src/types/index.ts:3-127 (schema)

  Type definition for MailchimpAutomation, used in the return type of listAutomations and for structuring the tool output.

  export interface MailchimpAutomation {
    id: string;
    name: string;
    status: "save" | "paused" | "sending";
    create_time: string;
    start_time?: string;
    from_name: string;
    from_email: string;
    subject: string;
    reply_to: string;
    to_name: string;
    title: string;
    type:
      | "abandonedCart"
      | "abandonedBrowse"
      | "api"
      | "bestCustomers"
      | "click"
      | "date"
      | "email"
      | "emailSeries"
      | "groupAdd"
      | "groupRemove"
      | "mandrill"
      | "product"
      | "purchase"
      | "signup"
      | "signupFollowUp"
      | "survey"
      | "visit"
      | "welcome";
    template_id?: number;
    delay?: number;
    delay_type?: "now" | "day" | "hour" | "week";
    delay_unit?: "day" | "hour" | "week";
    delay_value?: number;
    delay_direction?: "before" | "after";
    delay_full?: {
      delay_type: string;
      delay_unit: string;
      delay_value: number;
      delay_direction: string;
    };
    trigger_settings?: {
      workflow_type: string;
      workflow_title?: string;
      runtime?: {
        days?: number[];
        hours?: number[];
      };
      one_time?: boolean;
      one_time_date?: string;
    };
    tracking?: {
      opens: boolean;
      html_clicks: boolean;
      text_clicks: boolean;
      goal_tracking: boolean;
      ecomm360: boolean;
      google_analytics: string;
      clicktale: string;
      salesforce?: {
        campaign: boolean;
        notes: boolean;
      };
      capsule?: {
        notes: boolean;
      };
    };
    settings?: {
      title: string;
      from_name: string;
      reply_to: string;
      use_conversation: boolean;
      to_name: string;
      folder_id: string;
      authenticate: boolean;
      auto_footer: boolean;
      inline_css: boolean;
      auto_tweet: boolean;
      fb_comments: boolean;
      timewarp: boolean;
      template_id: number;
      drag_and_drop: boolean;
    };
    social_card?: {
      image_url?: string;
      description?: string;
      title?: string;
    };
    trigger_settings_workflow_type?: string;
    trigger_settings_workflow_title?: string;
    trigger_settings_runtime?: {
      days?: number[];
      hours?: number[];
    };
    trigger_settings_one_time?: boolean;
    trigger_settings_one_time_date?: string;
    report_summary?: {
      opens: number;
      unique_opens: number;
      open_rate: number;
      clicks: number;
      subscriber_clicks: number;
      click_rate: number;
      visits: number;
      unique_visits: number;
      conversion_rate: number;
      subscribes: number;
      ecommerce?: {
        total_revenue: number;
        currency_code: string;
        average_order_revenue: number;
        total_orders: number;
        total_products_sold: number;
      };
    };
    _links?: Array<{
      rel: string;
      href: string;
      method: string;
      targetSchema?: string;
      schema?: string;
    }>;
  }

• src/services/mailchimp.ts:98-104 (helper)

  Helper method in MailchimpService class that makes a paginated API request to Mailchimp's /automations endpoint to retrieve the list of automations.

  async listAutomations(): Promise<{ automations: MailchimpAutomation[] }> {
    return await this.makePaginatedRequest(
      "/automations",
      "create_time",
      "DESC"
    );
  }