Mailchimp

Mailchimp MCP Server for Cloudflare Workers

Available Tools

100 tools available in the Mailchimp MCP server. Each tool can be called by AI assistants to perform specific actions.

mailchimp_delete_file

Delete a file from the file manager.

Args:

fileId: File ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "number",
      "description": "File ID"
    }
  }
}

mailchimp_pause_automation

Pause all emails in an automation workflow.

Args:

workflowId: Automation workflow ID

Returns: Confirmation of pause.

{
  "type": "object",
  "required": [
    "workflowId"
  ],
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "Automation workflow ID"
    }
  }
}

mailchimp_get_folder

Get details of a specific folder.

Args:

folderId: Folder ID
format: Response format ('json' or 'markdown')

Returns: Folder details.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "folderId": {
      "type": "number",
      "description": "Folder ID"
    }
  }
}

mailchimp_create_folder

Create a new folder in the file manager.

Args:

name: Folder name

Returns: The created folder.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    }
  }
}

mailchimp_start_automation

Start all emails in an automation workflow.

Args:

workflowId: Automation workflow ID

Returns: Confirmation of start.

{
  "type": "object",
  "required": [
    "workflowId"
  ],
  "properties": {
    "workflowId": {
      "type": "string",
      "description": "Automation workflow ID"
    }
  }
}

mailchimp_list_audiences

List all audiences (lists) in the Mailchimp account.

Returns a paginated list of audiences with stats.

Args:

count: Number of audiences to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: List of audiences with member counts and engagement rates.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of audiences to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Pagination offset"
    }
  }
}

mailchimp_get_audience

Get details of a specific audience.

Args:

listId: The audience/list ID
format: Response format ('json' or 'markdown')

Returns: Audience details including settings, stats, and contact info.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_create_audience

Create a new audience (list).

Args:

name: Audience name
company: Company name for contact info
address1: Street address
city: City
state: State/province
zip: Postal code
country: Country code (e.g., 'US')
fromName: Default from name for campaigns
fromEmail: Default from email for campaigns
subject: Default email subject
language: Default language (e.g., 'en')
permissionReminder: Permission reminder text

Returns: The created audience.

{
  "type": "object",
  "required": [
    "name",
    "company",
    "address1",
    "city",
    "state",
    "zip",
    "country",
    "fromName",
    "fromEmail",
    "subject",
    "permissionReminder"
  ],
  "properties": {
    "zip": {
      "type": "string",
      "description": "Postal code"
    },
    "city": {
      "type": "string",
      "description": "City"
    },
    "name": {
      "type": "string",
      "description": "Audience name"
    },
    "state": {
      "type": "string",
      "description": "State/province"
    },
    "company": {
      "type": "string",
      "description": "Company name"
    },
    "country": {
      "type": "string",
      "description": "Country code"
    },
    "subject": {
      "type": "string",
      "description": "Default subject"
    },
    "address1": {
      "type": "string",
      "description": "Street address"
    },
    "fromName": {
      "type": "string",
      "description": "Default from name"
    },
    "language": {
      "type": "string",
      "default": "en",
      "description": "Default language"
    },
    "fromEmail": {
      "type": "string",
      "description": "Default from email"
    },
    "permissionReminder": {
      "type": "string",
      "description": "Permission reminder text"
    }
  }
}

mailchimp_update_audience

Update an existing audience.

Args:

listId: Audience/list ID to update
name: New audience name (optional)
permissionReminder: New permission reminder (optional)

Returns: The updated audience.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New audience name"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "permissionReminder": {
      "type": "string",
      "description": "New permission reminder"
    }
  }
}

mailchimp_delete_audience

Delete an audience. WARNING: This permanently deletes the audience and all its members.

Args:

listId: Audience/list ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID to delete"
    }
  }
}

mailchimp_list_automations

List automation workflows.

Automations are email series triggered by specific events or actions.

Args:

count: Number of automations to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of automation workflows.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_automation

Get details of a specific automation workflow.

Args:

workflowId: Automation workflow ID
format: Response format ('json' or 'markdown')

Returns: Automation details including settings, trigger, and report summary.

{
  "type": "object",
  "required": [
    "workflowId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workflowId": {
      "type": "string",
      "description": "Automation workflow ID"
    }
  }
}

mailchimp_list_automation_emails

List emails in an automation workflow.

Args:

workflowId: Automation workflow ID
format: Response format ('json' or 'markdown')

Returns: List of automation emails with settings and status.

{
  "type": "object",
  "required": [
    "workflowId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "workflowId": {
      "type": "string",
      "description": "Automation workflow ID"
    }
  }
}

mailchimp_get_automation_email

Get details of a specific automation email.

Args:

workflowId: Automation workflow ID
emailId: Automation email ID
format: Response format ('json' or 'markdown')

Returns: Automation email details.

{
  "type": "object",
  "required": [
    "workflowId",
    "emailId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "emailId": {
      "type": "string",
      "description": "Automation email ID"
    },
    "workflowId": {
      "type": "string",
      "description": "Automation workflow ID"
    }
  }
}

mailchimp_list_campaigns

List campaigns in the Mailchimp account.

Args:

status: Filter by status (save, paused, schedule, sending, sent, canceled, archived)
type: Filter by type (regular, plaintext, absplit, rss, variate)
count: Number of campaigns to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of campaigns.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "status": {
      "type": "string",
      "description": "Filter by campaign status"
    }
  }
}

mailchimp_get_campaign

Get details of a specific campaign.

Args:

campaignId: Campaign ID
format: Response format ('json' or 'markdown')

Returns: Campaign details including settings, tracking, and report summary.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_create_campaign

Create a new campaign.

Args:

type: Campaign type (regular, plaintext, absplit, rss, variate)
listId: Audience/list ID to send to
subjectLine: Email subject line
fromName: From name
replyTo: Reply-to email address
title: Campaign title (internal name)
previewText: Preview text shown in inbox (optional)

Returns: The created campaign.

{
  "type": "object",
  "required": [
    "listId",
    "subjectLine",
    "fromName",
    "replyTo",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Campaign title"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "replyTo": {
      "type": "string",
      "description": "Reply-to email"
    },
    "fromName": {
      "type": "string",
      "description": "From name"
    },
    "previewText": {
      "type": "string",
      "description": "Preview text"
    },
    "subjectLine": {
      "type": "string",
      "description": "Email subject line"
    }
  }
}

mailchimp_update_campaign

Update an existing campaign.

Args:

campaignId: Campaign ID to update
subjectLine: New subject line (optional)
fromName: New from name (optional)
replyTo: New reply-to email (optional)
title: New campaign title (optional)
previewText: New preview text (optional)

Returns: The updated campaign.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New campaign title"
    },
    "replyTo": {
      "type": "string",
      "description": "New reply-to email"
    },
    "fromName": {
      "type": "string",
      "description": "New from name"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    },
    "previewText": {
      "type": "string",
      "description": "New preview text"
    },
    "subjectLine": {
      "type": "string",
      "description": "New subject line"
    }
  }
}

mailchimp_delete_campaign

Delete a campaign.

Args:

campaignId: Campaign ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_send_campaign

Send a campaign immediately.

Args:

campaignId: Campaign ID to send

Returns: Confirmation of send initiation.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_schedule_campaign

Schedule a campaign for future sending.

Args:

campaignId: Campaign ID to schedule
scheduleTime: ISO 8601 datetime for when to send (e.g., '2024-12-25T10:00:00Z')

Returns: Confirmation of scheduling.

{
  "type": "object",
  "required": [
    "campaignId",
    "scheduleTime"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    },
    "scheduleTime": {
      "type": "string",
      "description": "ISO 8601 datetime"
    }
  }
}

mailchimp_unschedule_campaign

Unschedule a scheduled campaign.

Args:

campaignId: Campaign ID to unschedule

Returns: Confirmation of unscheduling.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_cancel_campaign

Cancel a campaign that is currently sending.

Args:

campaignId: Campaign ID to cancel

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_replicate_campaign

Create a copy of an existing campaign.

Args:

campaignId: Campaign ID to replicate

Returns: The new campaign copy.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_get_campaign_content

Get the HTML and plain text content of a campaign.

Args:

campaignId: Campaign ID

Returns: Campaign content (HTML and plain text).

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_get_product

Get details of a specific product.

Args:

storeId: Store ID
productId: Product ID
format: Response format ('json' or 'markdown')

Returns: Product details.

{
  "type": "object",
  "required": [
    "storeId",
    "productId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "productId": {
      "type": "string",
      "description": "Product ID"
    }
  }
}

mailchimp_set_campaign_content

Set the content for a campaign.

Args:

campaignId: Campaign ID
html: HTML content for the email
plainText: Plain text content (optional, auto-generated if not provided)
templateId: Use a template instead of raw HTML (optional)

Returns: The updated campaign content.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "html": {
      "type": "string",
      "description": "HTML content"
    },
    "plainText": {
      "type": "string",
      "description": "Plain text content"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    },
    "templateId": {
      "type": "number",
      "description": "Template ID to use"
    }
  }
}

mailchimp_pause_campaign

Pause an RSS campaign.

Args:

campaignId: Campaign ID to pause

Returns: Confirmation of pause.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_resume_campaign

Resume a paused RSS campaign.

Args:

campaignId: Campaign ID to resume

Returns: Confirmation of resume.

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_list_stores

List all e-commerce stores.

Args:

count: Number of stores to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of stores.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_store

Get details of a specific e-commerce store.

Args:

storeId: Store ID
format: Response format ('json' or 'markdown')

Returns: Store details.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_create_store

Create a new e-commerce store.

Args:

id: Unique store ID
listId: Audience/list ID to associate
name: Store name
currencyCode: Currency code (e.g., 'USD')
platform: E-commerce platform (optional)
domain: Store domain (optional)
emailAddress: Store email (optional)

Returns: The created store.

{
  "type": "object",
  "required": [
    "id",
    "listId",
    "name",
    "currencyCode"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique store ID"
    },
    "name": {
      "type": "string",
      "description": "Store name"
    },
    "domain": {
      "type": "string",
      "description": "Store domain"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "platform": {
      "type": "string",
      "description": "E-commerce platform"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code (e.g., USD)"
    },
    "emailAddress": {
      "type": "string",
      "description": "Store email"
    }
  }
}

mailchimp_delete_store

Delete an e-commerce store. WARNING: This deletes all associated customers, orders, products, and carts.

Args:

storeId: Store ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_list_customers

List customers for an e-commerce store.

Args:

storeId: Store ID
count: Number of customers to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of customers.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_get_customer

Get details of a specific customer.

Args:

storeId: Store ID
customerId: Customer ID
format: Response format ('json' or 'markdown')

Returns: Customer details.

{
  "type": "object",
  "required": [
    "storeId",
    "customerId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "customerId": {
      "type": "string",
      "description": "Customer ID"
    }
  }
}

mailchimp_create_customer

Create a new customer for an e-commerce store.

Args:

storeId: Store ID
id: Unique customer ID
emailAddress: Customer email
optInStatus: Marketing opt-in status
firstName: First name (optional)
lastName: Last name (optional)
company: Company name (optional)

Returns: The created customer.

{
  "type": "object",
  "required": [
    "storeId",
    "id",
    "emailAddress",
    "optInStatus"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique customer ID"
    },
    "company": {
      "type": "string",
      "description": "Company name"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "lastName": {
      "type": "string",
      "description": "Last name"
    },
    "firstName": {
      "type": "string",
      "description": "First name"
    },
    "optInStatus": {
      "type": "boolean",
      "description": "Marketing opt-in status"
    },
    "emailAddress": {
      "type": "string",
      "description": "Customer email"
    }
  }
}

mailchimp_delete_customer

Delete a customer from an e-commerce store.

Args:

storeId: Store ID
customerId: Customer ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "storeId",
    "customerId"
  ],
  "properties": {
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "customerId": {
      "type": "string",
      "description": "Customer ID"
    }
  }
}

mailchimp_list_products

List products for an e-commerce store.

Args:

storeId: Store ID
count: Number of products to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of products.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_list_folders

List folders in the file manager.

Args:

count: Number of folders to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of folders.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_create_product

Create a new product for an e-commerce store.

Args:

storeId: Store ID
id: Unique product ID
title: Product title
variants: Array of product variants (each with id, title, price)
description: Product description (optional)
type: Product type (optional)
vendor: Product vendor (optional)
imageUrl: Product image URL (optional)
url: Product URL (optional)

Returns: The created product.

{
  "type": "object",
  "required": [
    "storeId",
    "id",
    "title"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique product ID"
    },
    "url": {
      "type": "string",
      "description": "Product URL"
    },
    "type": {
      "type": "string",
      "description": "Product type"
    },
    "title": {
      "type": "string",
      "description": "Product title"
    },
    "vendor": {
      "type": "string",
      "description": "Product vendor"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "imageUrl": {
      "type": "string",
      "description": "Product image URL"
    },
    "description": {
      "type": "string",
      "description": "Product description"
    }
  }
}

mailchimp_delete_product

Delete a product from an e-commerce store.

Args:

storeId: Store ID
productId: Product ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "storeId",
    "productId"
  ],
  "properties": {
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "productId": {
      "type": "string",
      "description": "Product ID"
    }
  }
}

mailchimp_list_orders

List orders for an e-commerce store.

Args:

storeId: Store ID
count: Number of orders to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of orders.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_get_order

Get details of a specific order.

Args:

storeId: Store ID
orderId: Order ID
format: Response format ('json' or 'markdown')

Returns: Order details.

{
  "type": "object",
  "required": [
    "storeId",
    "orderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderId": {
      "type": "string",
      "description": "Order ID"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_create_order

Create a new order for an e-commerce store.

Args:

storeId: Store ID
id: Unique order ID
customerId: Customer ID
currencyCode: Currency code
orderTotal: Order total amount
lines: Order line items (each with id, productId, productVariantId, quantity, price)
customerEmail: Customer email (optional, for creating customer)
financialStatus: Financial status (optional)
fulfillmentStatus: Fulfillment status (optional)

Returns: The created order.

{
  "type": "object",
  "required": [
    "storeId",
    "id",
    "customerId",
    "currencyCode",
    "orderTotal"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique order ID"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "customerId": {
      "type": "string",
      "description": "Customer ID"
    },
    "orderTotal": {
      "type": "number",
      "description": "Order total amount"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code"
    },
    "customerEmail": {
      "type": "string",
      "description": "Customer email"
    },
    "financialStatus": {
      "type": "string",
      "description": "Financial status"
    },
    "fulfillmentStatus": {
      "type": "string",
      "description": "Fulfillment status"
    }
  }
}

mailchimp_delete_order

Delete an order from an e-commerce store.

Args:

storeId: Store ID
orderId: Order ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "storeId",
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "string",
      "description": "Order ID"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_list_carts

List abandoned carts for an e-commerce store.

Args:

storeId: Store ID
count: Number of carts to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of carts.

{
  "type": "object",
  "required": [
    "storeId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_get_cart

Get details of a specific cart.

Args:

storeId: Store ID
cartId: Cart ID
format: Response format ('json' or 'markdown')

Returns: Cart details.

{
  "type": "object",
  "required": [
    "storeId",
    "cartId"
  ],
  "properties": {
    "cartId": {
      "type": "string",
      "description": "Cart ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_create_cart

Create a new cart for an e-commerce store.

Args:

storeId: Store ID
id: Unique cart ID
customerId: Customer ID
currencyCode: Currency code
orderTotal: Cart total amount
lines: Cart line items (each with id, productId, productVariantId, quantity, price)
customerEmail: Customer email (optional)
checkoutUrl: Checkout URL (optional)

Returns: The created cart.

{
  "type": "object",
  "required": [
    "storeId",
    "id",
    "customerId",
    "currencyCode",
    "orderTotal"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique cart ID"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    },
    "customerId": {
      "type": "string",
      "description": "Customer ID"
    },
    "orderTotal": {
      "type": "number",
      "description": "Cart total amount"
    },
    "checkoutUrl": {
      "type": "string",
      "description": "Checkout URL"
    },
    "currencyCode": {
      "type": "string",
      "description": "Currency code"
    },
    "customerEmail": {
      "type": "string",
      "description": "Customer email"
    }
  }
}

mailchimp_delete_cart

Delete a cart from an e-commerce store.

Args:

storeId: Store ID
cartId: Cart ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "storeId",
    "cartId"
  ],
  "properties": {
    "cartId": {
      "type": "string",
      "description": "Cart ID"
    },
    "storeId": {
      "type": "string",
      "description": "Store ID"
    }
  }
}

mailchimp_list_files

List files in the file manager.

Args:

count: Number of files to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of files.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_file

Get details of a specific file.

Args:

fileId: File ID
format: Response format ('json' or 'markdown')

Returns: File details including URL.

{
  "type": "object",
  "required": [
    "fileId"
  ],
  "properties": {
    "fileId": {
      "type": "number",
      "description": "File ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

mailchimp_update_folder

Update a folder name.

Args:

folderId: Folder ID
name: New folder name

Returns: The updated folder.

{
  "type": "object",
  "required": [
    "folderId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New folder name"
    },
    "folderId": {
      "type": "number",
      "description": "Folder ID"
    }
  }
}

mailchimp_delete_folder

Delete a folder from the file manager.

Args:

folderId: Folder ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "folderId": {
      "type": "number",
      "description": "Folder ID"
    }
  }
}

mailchimp_list_interest_categories

List interest categories (groups) for an audience.

Interest categories are the group titles that contain individual interests.

Args:

listId: Audience/list ID
count: Number of categories to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of interest categories.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_interest_category

Get details of a specific interest category.

Args:

listId: Audience/list ID
categoryId: Interest category ID
format: Response format ('json' or 'markdown')

Returns: Interest category details.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    }
  }
}

mailchimp_create_interest_category

Create a new interest category (group).

Args:

listId: Audience/list ID
title: Category title
type: Display type (checkboxes, dropdown, radio, hidden)
displayOrder: Display order (optional)

Returns: The created interest category.

{
  "type": "object",
  "required": [
    "listId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Category title"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "displayOrder": {
      "type": "number",
      "description": "Display order"
    }
  }
}

mailchimp_update_interest_category

Update an existing interest category.

Args:

listId: Audience/list ID
categoryId: Interest category ID
title: New title (optional)
type: New display type (optional)
displayOrder: New display order (optional)

Returns: The updated interest category.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New title"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    },
    "displayOrder": {
      "type": "number",
      "description": "New display order"
    }
  }
}

mailchimp_delete_interest_category

Delete an interest category and all its interests.

Args:

listId: Audience/list ID
categoryId: Interest category ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    }
  }
}

mailchimp_list_interests

List interests (group options) in an interest category.

Args:

listId: Audience/list ID
categoryId: Interest category ID
count: Number of interests to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of interests with subscriber counts.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    }
  }
}

mailchimp_get_interest

Get details of a specific interest.

Args:

listId: Audience/list ID
categoryId: Interest category ID
interestId: Interest ID
format: Response format ('json' or 'markdown')

Returns: Interest details.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId",
    "interestId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    },
    "interestId": {
      "type": "string",
      "description": "Interest ID"
    }
  }
}

mailchimp_create_interest

Create a new interest in an interest category.

Args:

listId: Audience/list ID
categoryId: Interest category ID
name: Interest name
displayOrder: Display order (optional)

Returns: The created interest.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Interest name"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    },
    "displayOrder": {
      "type": "number",
      "description": "Display order"
    }
  }
}

mailchimp_update_interest

Update an existing interest.

Args:

listId: Audience/list ID
categoryId: Interest category ID
interestId: Interest ID
name: New interest name (optional)
displayOrder: New display order (optional)

Returns: The updated interest.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId",
    "interestId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New interest name"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    },
    "interestId": {
      "type": "string",
      "description": "Interest ID"
    },
    "displayOrder": {
      "type": "number",
      "description": "New display order"
    }
  }
}

mailchimp_delete_interest

Delete an interest.

Args:

listId: Audience/list ID
categoryId: Interest category ID
interestId: Interest ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId",
    "categoryId",
    "interestId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "categoryId": {
      "type": "string",
      "description": "Interest category ID"
    },
    "interestId": {
      "type": "string",
      "description": "Interest ID"
    }
  }
}

mailchimp_list_landing_pages

List all landing pages.

Args:

count: Number of pages to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of landing pages.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_landing_page

Get details of a specific landing page.

Args:

pageId: Landing page ID
format: Response format ('json' or 'markdown')

Returns: Landing page details.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    }
  }
}

mailchimp_create_landing_page

Create a new landing page (unpublished).

Args:

name: Page name
listId: Audience/list ID to associate with
title: Page title (optional)
description: Page description (optional)
storeId: E-commerce store ID (optional)
templateId: Template ID to use (optional)

Returns: The created landing page.

{
  "type": "object",
  "required": [
    "name",
    "listId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Page name"
    },
    "title": {
      "type": "string",
      "description": "Page title"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "storeId": {
      "type": "string",
      "description": "E-commerce store ID"
    },
    "templateId": {
      "type": "number",
      "description": "Template ID"
    },
    "description": {
      "type": "string",
      "description": "Page description"
    }
  }
}

mailchimp_update_landing_page

Update an existing landing page.

Args:

pageId: Landing page ID
name: New page name (optional)
title: New page title (optional)
description: New page description (optional)

Returns: The updated landing page.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New page name"
    },
    "title": {
      "type": "string",
      "description": "New page title"
    },
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    },
    "description": {
      "type": "string",
      "description": "New page description"
    }
  }
}

mailchimp_delete_landing_page

Delete a landing page.

Args:

pageId: Landing page ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    }
  }
}

mailchimp_publish_landing_page

Publish a landing page.

Args:

pageId: Landing page ID to publish

Returns: Confirmation of publication.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    }
  }
}

mailchimp_unpublish_landing_page

Unpublish a landing page.

Args:

pageId: Landing page ID to unpublish

Returns: Confirmation of unpublication.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    }
  }
}

mailchimp_get_landing_page_content

Get the HTML content of a landing page.

Args:

pageId: Landing page ID
format: Response format ('json' or 'markdown')

Returns: Landing page HTML content.

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageId": {
      "type": "string",
      "description": "Landing page ID"
    }
  }
}

mailchimp_list_members

List members (subscribers) in an audience.

Args:

listId: Audience/list ID
status: Filter by status (subscribed, unsubscribed, cleaned, pending, transactional, archived)
count: Number of members to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of members with status and engagement data.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_member

Get a member by their subscriber hash or email address.

Args:

listId: Audience/list ID
email: Member's email address
format: Response format ('json' or 'markdown')

Returns: Member details including status, merge fields, tags, and engagement stats.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email address"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_add_member

Add a new member (subscriber) to an audience.

Args:

listId: Audience/list ID
email: Email address
status: Subscription status (subscribed, pending, etc.)
mergeFields: Custom field values (e.g., { "FNAME": "John", "LNAME": "Doe" })
tags: Tags to add to the member
vip: Mark as VIP subscriber
language: Member's language preference

Returns: The created member record.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "vip": {
      "type": "boolean",
      "description": "Mark as VIP"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to add"
    },
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "language": {
      "type": "string",
      "description": "Language preference"
    },
    "mergeFields": {
      "type": "object",
      "description": "Custom merge field values"
    }
  }
}

mailchimp_update_member

Update an existing member.

Args:

listId: Audience/list ID
email: Current email address of the member
newEmail: New email address (optional)
status: New subscription status (optional)
mergeFields: Updated merge field values (optional)
vip: Update VIP status (optional)
language: Update language preference (optional)

Returns: The updated member record.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "vip": {
      "type": "boolean",
      "description": "Update VIP status"
    },
    "email": {
      "type": "string",
      "description": "Current member email"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "language": {
      "type": "string",
      "description": "Update language"
    },
    "newEmail": {
      "type": "string",
      "description": "New email address"
    },
    "mergeFields": {
      "type": "object",
      "description": "Updated merge fields"
    }
  }
}

mailchimp_archive_member

Archive a member (soft delete - can be re-added later).

Args:

listId: Audience/list ID
email: Member's email address

Returns: Confirmation of archival.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_delete_member

Permanently delete a member. WARNING: This is irreversible.

Args:

listId: Audience/list ID
email: Member's email address

Returns: Confirmation of permanent deletion.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_search_members

Search for members across all audiences.

Args:

listId: Audience/list ID to search in
query: Search query (searches email and merge fields)
format: Response format ('json' or 'markdown')

Returns: Matching members.

{
  "type": "object",
  "required": [
    "listId",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_get_member_tags

Get all tags for a member.

Args:

listId: Audience/list ID
email: Member's email address

Returns: List of tags assigned to the member.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    }
  }
}

mailchimp_update_member_tags

Add or remove tags from a member.

Args:

listId: Audience/list ID
email: Member's email address
tagsToAdd: Tags to add (active)
tagsToRemove: Tags to remove (inactive)

Returns: Confirmation of tag update.

{
  "type": "object",
  "required": [
    "listId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Member email"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "tagsToAdd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to add"
    },
    "tagsToRemove": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tags to remove"
    }
  }
}

mailchimp_batch_subscribe

Add or update multiple members at once.

Args:

listId: Audience/list ID
members: Array of member objects with email, status, and optional merge fields
updateExisting: Whether to update existing members (default: false)

Returns: Batch operation results with counts.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "updateExisting": {
      "type": "boolean",
      "default": false,
      "description": "Update existing members"
    }
  }
}

mailchimp_list_merge_fields

List merge fields for an audience.

Merge fields are custom fields like FNAME, LNAME, BIRTHDAY, etc.

Args:

listId: Audience/list ID
count: Number of fields to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of merge fields.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_merge_field

Get details of a specific merge field.

Args:

listId: Audience/list ID
mergeId: Merge field ID
format: Response format ('json' or 'markdown')

Returns: Merge field details including tag, type, and options.

{
  "type": "object",
  "required": [
    "listId",
    "mergeId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "mergeId": {
      "type": "number",
      "description": "Merge field ID"
    }
  }
}

mailchimp_create_merge_field

Create a new merge field for an audience.

Args:

listId: Audience/list ID
name: Field display name
type: Field type (text, number, address, phone, date, url, imageurl, radio, dropdown, birthday, zip)
tag: Merge tag (e.g., 'COMPANY') - auto-generated if not provided
required: Whether the field is required
defaultValue: Default value for the field
public: Whether the field is public
helpText: Help text shown to subscribers
choices: Array of choices for radio/dropdown fields

Returns: The created merge field.

{
  "type": "object",
  "required": [
    "listId",
    "name"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Merge tag"
    },
    "name": {
      "type": "string",
      "description": "Field display name"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "public": {
      "type": "boolean",
      "description": "Is public"
    },
    "choices": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Choices for radio/dropdown"
    },
    "helpText": {
      "type": "string",
      "description": "Help text"
    },
    "required": {
      "type": "boolean",
      "description": "Is required"
    },
    "defaultValue": {
      "type": "string",
      "description": "Default value"
    }
  }
}

mailchimp_update_merge_field

Update an existing merge field.

Args:

listId: Audience/list ID
mergeId: Merge field ID to update
name: New field name (optional)
tag: New merge tag (optional)
required: Update required status (optional)
defaultValue: New default value (optional)
public: Update public status (optional)
helpText: New help text (optional)
choices: New choices for radio/dropdown (optional)

Returns: The updated merge field.

{
  "type": "object",
  "required": [
    "listId",
    "mergeId"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "New merge tag"
    },
    "name": {
      "type": "string",
      "description": "New field name"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "public": {
      "type": "boolean",
      "description": "Update public status"
    },
    "choices": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New choices"
    },
    "mergeId": {
      "type": "number",
      "description": "Merge field ID"
    },
    "helpText": {
      "type": "string",
      "description": "New help text"
    },
    "required": {
      "type": "boolean",
      "description": "Update required status"
    },
    "defaultValue": {
      "type": "string",
      "description": "New default value"
    }
  }
}

mailchimp_delete_merge_field

Delete a merge field. WARNING: This removes the field and its data from all members.

Args:

listId: Audience/list ID
mergeId: Merge field ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId",
    "mergeId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "mergeId": {
      "type": "number",
      "description": "Merge field ID"
    }
  }
}

mailchimp_list_reports

List campaign reports.

Args:

count: Number of reports to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of campaign reports with key metrics.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_campaign_report

Get detailed report for a specific campaign.

Args:

campaignId: Campaign ID
format: Response format ('json' or 'markdown')

Returns: Comprehensive campaign report including:

Opens (total, unique, open rate)
Clicks (total, unique, click rate)
Bounces (hard, soft, syntax errors)
Unsubscribes
Abuse reports
Forward stats
E-commerce data (if connected)

{
  "type": "object",
  "required": [
    "campaignId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "campaignId": {
      "type": "string",
      "description": "Campaign ID"
    }
  }
}

mailchimp_list_segments

List segments for an audience.

Args:

listId: Audience/list ID
count: Number of segments to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of segments with member counts.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_segment

Get details of a specific segment.

Args:

listId: Audience/list ID
segmentId: Segment ID
format: Response format ('json' or 'markdown')

Returns: Segment details including conditions and member count.

{
  "type": "object",
  "required": [
    "listId",
    "segmentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "segmentId": {
      "type": "number",
      "description": "Segment ID"
    }
  }
}

mailchimp_create_segment

Create a new segment.

For static segments:

Provide a list of email addresses in staticSegment

For saved (dynamic) segments:

Use options.match ('any' or 'all') and options.conditions

Args:

listId: Audience/list ID
name: Segment name
staticSegment: Array of email addresses for static segment (optional)
match: Condition matching ('any' or 'all') for dynamic segment (optional)
conditions: Segment conditions for dynamic segment (optional)

Returns: The created segment.

{
  "type": "object",
  "required": [
    "listId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Segment name"
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "description": "Condition matching"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "staticSegment": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses for static segment"
    }
  }
}

mailchimp_update_segment

Update an existing segment.

Args:

listId: Audience/list ID
segmentId: Segment ID to update
name: New segment name (optional)
staticSegment: New email addresses for static segment (optional)
match: New condition matching (optional)
conditions: New segment conditions (optional)

Returns: The updated segment.

{
  "type": "object",
  "required": [
    "listId",
    "segmentId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New segment name"
    },
    "match": {
      "enum": [
        "any",
        "all"
      ],
      "type": "string",
      "description": "Condition matching"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "segmentId": {
      "type": "number",
      "description": "Segment ID"
    },
    "staticSegment": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New email addresses"
    }
  }
}

mailchimp_delete_segment

Delete a segment.

Args:

listId: Audience/list ID
segmentId: Segment ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId",
    "segmentId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "segmentId": {
      "type": "number",
      "description": "Segment ID"
    }
  }
}

mailchimp_batch_segment_members

Add or remove members from a static segment.

Args:

listId: Audience/list ID
segmentId: Segment ID
membersToAdd: Email addresses to add (optional)
membersToRemove: Email addresses to remove (optional)

Returns: Counts of added and removed members.

{
  "type": "object",
  "required": [
    "listId",
    "segmentId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "segmentId": {
      "type": "number",
      "description": "Segment ID"
    },
    "membersToAdd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails to add"
    },
    "membersToRemove": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails to remove"
    }
  }
}

mailchimp_list_tags

List all tags for an audience.

Tags are used to organize and segment members.

Args:

listId: Audience/list ID
count: Number of tags to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of tags with member counts.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Audience/list ID"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_list_templates

List email templates.

Args:

type: Filter by template type ('user', 'base', 'gallery')
count: Number of templates to return (1-100, default: 10)
offset: Pagination offset (default: 0)
format: Response format ('json' or 'markdown')

Returns: Paginated list of templates.

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "user",
        "base",
        "gallery"
      ],
      "type": "string",
      "description": "Filter by template type"
    },
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    }
  }
}

mailchimp_get_template

Get details of a specific template.

Args:

templateId: Template ID
format: Response format ('json' or 'markdown')

Returns: Template details.

{
  "type": "object",
  "required": [
    "templateId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "templateId": {
      "type": "number",
      "description": "Template ID"
    }
  }
}

mailchimp_create_template

Create a new email template.

Args:

name: Template name
html: HTML content for the template
folderId: Folder to store the template in (optional)

Returns: The created template.

{
  "type": "object",
  "required": [
    "name",
    "html"
  ],
  "properties": {
    "html": {
      "type": "string",
      "description": "HTML content"
    },
    "name": {
      "type": "string",
      "description": "Template name"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

mailchimp_update_template

Update an existing template.

Args:

templateId: Template ID to update
name: New template name (optional)
html: New HTML content (optional)
folderId: New folder ID (optional)

Returns: The updated template.

{
  "type": "object",
  "required": [
    "templateId"
  ],
  "properties": {
    "html": {
      "type": "string",
      "description": "New HTML content"
    },
    "name": {
      "type": "string",
      "description": "New template name"
    },
    "folderId": {
      "type": "string",
      "description": "New folder ID"
    },
    "templateId": {
      "type": "number",
      "description": "Template ID"
    }
  }
}

mailchimp_delete_template

Delete a template.

Args:

templateId: Template ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "templateId"
  ],
  "properties": {
    "templateId": {
      "type": "number",
      "description": "Template ID"
    }
  }
}