mailchimp-automation
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMailchimp Automation via Rube MCP
通过Rube MCP实现Mailchimp自动化
Automate Mailchimp email marketing workflows including campaign creation and sending, audience/list management, subscriber operations, segmentation, and performance analytics through Composio's Mailchimp toolkit.
借助Composio的Mailchimp工具包,自动化Mailchimp电子邮件营销工作流,包括营销活动的创建与发送、受众/列表管理、订阅者操作、群体细分以及效果分析。
Prerequisites
前置条件
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Mailchimp connection via with toolkit
RUBE_MANAGE_CONNECTIONSmailchimp - Always call first to get current tool schemas
RUBE_SEARCH_TOOLS
- 必须已连接Rube MCP(需提供RUBE_SEARCH_TOOLS)
- 通过完成Mailchimp的激活连接,工具包为
RUBE_MANAGE_CONNECTIONSmailchimp - 请始终先调用以获取最新的工具架构
RUBE_SEARCH_TOOLS
Setup
设置步骤
Get Rube MCP: Add as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
https://rube.app/mcp- Verify Rube MCP is available by confirming responds
RUBE_SEARCH_TOOLS - Call with toolkit
RUBE_MANAGE_CONNECTIONSmailchimp - If connection is not ACTIVE, follow the returned auth link to complete Mailchimp OAuth
- Confirm connection status shows ACTIVE before running any workflows
获取Rube MCP:在客户端配置中添加作为MCP服务器。无需API密钥——只需添加端点即可使用。
https://rube.app/mcp- 通过确认能正常响应,验证Rube MCP是否可用
RUBE_SEARCH_TOOLS - 调用并指定工具包
RUBE_MANAGE_CONNECTIONSmailchimp - 如果连接状态未显示为ACTIVE,请按照返回的授权链接完成Mailchimp OAuth认证
- 在运行任何工作流之前,确认连接状态为ACTIVE
Core Workflows
核心工作流
1. Create and Send Email Campaigns
1. 创建并发送营销活动
When to use: User wants to create, configure, test, and send an email campaign.
Tool sequence:
- - List available audiences and get list_id [Prerequisite]
MAILCHIMP_GET_LISTS_INFO - - Create a new campaign with type, audience, subject, from name [Required]
MAILCHIMP_ADD_CAMPAIGN - - Set HTML content for the campaign [Required]
MAILCHIMP_SET_CAMPAIGN_CONTENT - - Send preview to reviewers before live send [Optional]
MAILCHIMP_SEND_TEST_EMAIL - - Send the campaign immediately [Required]
MAILCHIMP_SEND_CAMPAIGN - - Schedule for future delivery instead of immediate send [Optional]
MAILCHIMP_SCHEDULE_CAMPAIGN
Key parameters for MAILCHIMP_ADD_CAMPAIGN:
- : "regular", "plaintext", "rss", or "variate" (required)
type - : Audience/list ID for recipients
recipients__list__id - : Email subject line
settings__subject__line - : Sender display name
settings__from__name - : Reply-to email address (required for sending)
settings__reply__to - : Internal campaign title
settings__title - : Preview text shown in inbox
settings__preview__text
Key parameters for MAILCHIMP_SET_CAMPAIGN_CONTENT:
- : Campaign ID from creation step (required)
campaign_id - : Raw HTML content for the email
html - : Plain-text version (auto-generated if omitted)
plain_text - : Use a pre-built template instead of raw HTML
template__id
Pitfalls:
- is irreversible; always send a test email first and get explicit user approval
MAILCHIMP_SEND_CAMPAIGN - Campaign must be in "save" (draft) status with valid audience, subject, from name, verified email, and content before sending
- requires a valid future datetime; past timestamps fail
MAILCHIMP_SCHEDULE_CAMPAIGN - Templates and HTML content must include compliant footer/unsubscribe merge tags
- Mailchimp uses double-underscore notation for nested params (e.g., )
settings__subject__line
适用场景:用户需要创建、配置、测试并发送电子邮件营销活动。
工具执行顺序:
- - 列出可用受众并获取list_id [前置步骤]
MAILCHIMP_GET_LISTS_INFO - - 创建新营销活动,指定类型、受众、主题、发件人名称 [必填]
MAILCHIMP_ADD_CAMPAIGN - - 设置营销活动的HTML内容 [必填]
MAILCHIMP_SET_CAMPAIGN_CONTENT - - 在正式发送前向审核人员发送预览邮件 [可选]
MAILCHIMP_SEND_TEST_EMAIL - - 立即发送营销活动 [必填]
MAILCHIMP_SEND_CAMPAIGN - - 安排在未来某个时间发送,而非立即发送 [可选]
MAILCHIMP_SCHEDULE_CAMPAIGN
MAILCHIMP_ADD_CAMPAIGN的关键参数:
- : "regular", "plaintext", "rss", or "variate" (required)
type - : 收件人的受众/列表ID
recipients__list__id - : 邮件主题
settings__subject__line - : 发件人显示名称
settings__from__name - : 回复邮箱地址 (发送时必填)
settings__reply__to - : 营销活动内部标题
settings__title - : 收件箱中显示的预览文本
settings__preview__text
MAILCHIMP_SET_CAMPAIGN_CONTENT的关键参数:
- : 创建步骤返回的营销活动ID (必填)
campaign_id - : 邮件的原始HTML内容
html - : 纯文本版本 (若省略则自动生成)
plain_text - : 使用预构建模板而非原始HTML
template__id
注意事项:
- 操作不可撤销;请务必先发送测试邮件并获得用户明确批准
MAILCHIMP_SEND_CAMPAIGN - 营销活动必须处于"save"(草稿)状态,且拥有有效的受众、主题、发件人名称、已验证邮箱及内容,才能进行发送
- 需要有效的未来时间戳;过去的时间戳会导致操作失败
MAILCHIMP_SCHEDULE_CAMPAIGN - 模板和HTML内容必须包含合规的页脚/退订合并标签
- Mailchimp使用双下划线表示嵌套参数 (例如)
settings__subject__line
2. Manage Audiences and Subscribers
2. 管理受众与订阅者
When to use: User wants to view audiences, list subscribers, or check subscriber details.
Tool sequence:
- - List all audiences with member counts [Required]
MAILCHIMP_GET_LISTS_INFO - - Get details for a specific audience [Optional]
MAILCHIMP_GET_LIST_INFO - - List members with status filter and pagination [Required]
MAILCHIMP_LIST_MEMBERS_INFO - - Search by email or name across lists [Optional]
MAILCHIMP_SEARCH_MEMBERS - - Get detailed profile for a specific subscriber [Optional]
MAILCHIMP_GET_MEMBER_INFO - - List segments within an audience [Optional]
MAILCHIMP_LIST_SEGMENTS
Key parameters for MAILCHIMP_LIST_MEMBERS_INFO:
- : Audience ID (required)
list_id - : "subscribed", "unsubscribed", "cleaned", "pending", "transactional", "archived"
status - : Records per page (default 10, max 1000)
count - : Pagination offset (default 0)
offset - : "timestamp_opt", "timestamp_signup", or "last_changed"
sort_field - : Comma-separated list to limit response size
fields
Pitfalls:
- and
stats.avg_open_rateare 0-1 fractions, NOT 0-100 percentagesstats.avg_click_rate - Always use to filter active subscribers; omitting returns all statuses
status="subscribed" - Must paginate using and
countuntil collected members matchoffsettotal_items - Large list responses may be truncated; data is under
response.data.members
适用场景:用户需要查看受众、列出订阅者或查看订阅者详情。
工具执行顺序:
- - 列出所有受众及成员数量 [必填]
MAILCHIMP_GET_LISTS_INFO - - 获取特定受众的详细信息 [可选]
MAILCHIMP_GET_LIST_INFO - - 按状态筛选并分页列出成员 [必填]
MAILCHIMP_LIST_MEMBERS_INFO - - 跨列表按邮箱或姓名搜索 [可选]
MAILCHIMP_SEARCH_MEMBERS - - 获取特定订阅者的详细资料 [可选]
MAILCHIMP_GET_MEMBER_INFO - - 列出受众内的细分群体 [可选]
MAILCHIMP_LIST_SEGMENTS
MAILCHIMP_LIST_MEMBERS_INFO的关键参数:
- : 受众ID (必填)
list_id - : "subscribed", "unsubscribed", "cleaned", "pending", "transactional", "archived"
status - : 每页记录数 (默认10, 最大1000)
count - : 分页偏移量 (默认0)
offset - : "timestamp_opt", "timestamp_signup", or "last_changed"
sort_field - : 逗号分隔的字段列表,用于限制响应大小
fields
注意事项:
- 和
stats.avg_open_rate是0-1的小数,而非0-100的百分比stats.avg_click_rate - 请始终使用筛选活跃订阅者;若省略则返回所有状态的订阅者
status="subscribed" - 必须使用和
count进行分页,直到收集的成员数与响应中的offset匹配total_items - 大型列表的响应可能会被截断;数据位于下
response.data.members
3. Add and Update Subscribers
3. 添加与更新订阅者
When to use: User wants to add new subscribers, update existing ones, or bulk-manage list membership.
Tool sequence:
- - Validate target audience exists [Prerequisite]
MAILCHIMP_GET_LIST_INFO - - Check if contact already exists [Optional]
MAILCHIMP_SEARCH_MEMBERS - - Upsert subscriber (create or update) [Required]
MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER - - Add new subscriber (create only) [Optional]
MAILCHIMP_ADD_MEMBER_TO_LIST - - Bulk manage segment membership [Optional]
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
Key parameters for MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER:
- : Audience ID (required)
list_id - : MD5 hash of lowercase email (required)
subscriber_hash - : Subscriber email (required)
email_address - : Status for new subscribers: "subscribed", "pending", etc. (required)
status_if_new - : Status for existing subscribers
status - : Object with merge tag keys (e.g.,
merge_fields){"FNAME": "John", "LNAME": "Doe"} - : Array of tag strings
tags
Key parameters for MAILCHIMP_ADD_MEMBER_TO_LIST:
- : Audience ID (required)
list_id - : Subscriber email (required)
email_address - : "subscribed", "pending", "unsubscribed", "cleaned", "transactional" (required)
status
Pitfalls:
- must be MD5 of the lowercase email; incorrect casing causes 404s or duplicates
subscriber_hash - Use (upsert) instead of
MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBERto avoid duplicate errorsMAILCHIMP_ADD_MEMBER_TO_LIST - determines status only for new contacts; existing contacts use
status_if_newstatus - Use to bypass required merge field validation
skip_merge_validation: true - manages static segment membership, not list membership
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
适用场景:用户需要添加新订阅者、更新现有订阅者或批量管理列表成员。
工具执行顺序:
- - 验证目标受众是否存在 [前置步骤]
MAILCHIMP_GET_LIST_INFO - - 检查联系人是否已存在 [可选]
MAILCHIMP_SEARCH_MEMBERS - - 插入或更新订阅者(创建或更新) [必填]
MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER - - 添加新订阅者(仅创建) [可选]
MAILCHIMP_ADD_MEMBER_TO_LIST - - 批量管理细分群体成员 [可选]
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER的关键参数:
- : 受众ID (必填)
list_id - : 邮箱小写形式的MD5哈希值 (必填)
subscriber_hash - : 订阅者邮箱 (必填)
email_address - : 新订阅者的状态: "subscribed", "pending", etc. (required)
status_if_new - : 现有订阅者的状态
status - : 包含合并标签键的对象 (例如
merge_fields){"FNAME": "John", "LNAME": "Doe"} - : 标签字符串数组
tags
MAILCHIMP_ADD_MEMBER_TO_LIST的关键参数:
- : 受众ID (必填)
list_id - : 订阅者邮箱 (必填)
email_address - : "subscribed", "pending", "unsubscribed", "cleaned", "transactional" (required)
status
注意事项:
- 必须是邮箱小写形式的MD5哈希值;大小写错误会导致404错误或重复记录
subscriber_hash - 请使用(插入更新)而非
MAILCHIMP_ADD_OR_UPDATE_LIST_MEMBER,以避免重复错误MAILCHIMP_ADD_MEMBER_TO_LIST - 仅适用于新联系人;现有联系人使用
status_if_new参数status - 使用可绕过必填合并字段的验证
skip_merge_validation: true - 用于管理静态细分群体成员,而非列表成员
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
4. View Campaign Reports and Analytics
4. 查看营销活动报告与分析
When to use: User wants to review campaign performance, open rates, click rates, or subscriber engagement.
Tool sequence:
- - List sent campaigns with report summaries [Required]
MAILCHIMP_LIST_CAMPAIGNS - - Find campaigns by name, subject, or content [Optional]
MAILCHIMP_SEARCH_CAMPAIGNS - - Get detailed performance report for a campaign [Required]
MAILCHIMP_GET_CAMPAIGN_REPORT - - Bulk fetch reports across multiple campaigns [Optional]
MAILCHIMP_LIST_CAMPAIGN_REPORTS - - Get link-level click statistics [Optional]
MAILCHIMP_LIST_CAMPAIGN_DETAILS - - Drill into specific link click data [Optional]
MAILCHIMP_GET_CAMPAIGN_LINK_DETAILS - - See who clicked a specific link [Optional]
MAILCHIMP_LIST_CLICKED_LINK_SUBSCRIBERS - - Get per-subscriber campaign activity [Optional]
MAILCHIMP_GET_SUBSCRIBER_EMAIL_ACTIVITY - - Retrieve campaign HTML content [Optional]
MAILCHIMP_GET_CAMPAIGN_CONTENT
Key parameters for MAILCHIMP_LIST_CAMPAIGNS:
- : "save", "paused", "schedule", "sending", "sent"
status - /
count: Pagination (default 10, max 1000)offset - /
since_send_time: ISO 8601 date range filterbefore_send_time - : "create_time" or "send_time"
sort_field - : Limit response fields for performance
fields
Key parameters for MAILCHIMP_GET_CAMPAIGN_REPORT:
- : Campaign ID (required)
campaign_id - Returns: opens, clicks, bounces, unsubscribes, timeseries, industry_stats
Pitfalls:
- only returns high-level
MAILCHIMP_LIST_CAMPAIGNS; usereport_summaryfor detailed metricsMAILCHIMP_GET_CAMPAIGN_REPORT - Draft/unsent campaigns lack meaningful report data
- When using parameter on LIST_CAMPAIGNS, explicitly request
fieldsandsend_timesubfieldsreport_summary - Pagination defaults are low (10 records); iterate with and
countuntiloffsetis coveredtotal_items - is ISO 8601 with timezone; parse carefully
send_time
适用场景:用户需要查看营销活动效果、打开率、点击率或订阅者参与度。
工具执行顺序:
- - 列出已发送的营销活动及报告摘要 [必填]
MAILCHIMP_LIST_CAMPAIGNS - - 按名称、主题或内容查找营销活动 [可选]
MAILCHIMP_SEARCH_CAMPAIGNS - - 获取特定营销活动的详细效果报告 [必填]
MAILCHIMP_GET_CAMPAIGN_REPORT - - 批量获取多个营销活动的报告 [可选]
MAILCHIMP_LIST_CAMPAIGN_REPORTS - - 获取链接级别的点击统计数据 [可选]
MAILCHIMP_LIST_CAMPAIGN_DETAILS - - 深入查看特定链接的点击数据 [可选]
MAILCHIMP_GET_CAMPAIGN_LINK_DETAILS - - 查看点击特定链接的订阅者 [可选]
MAILCHIMP_LIST_CLICKED_LINK_SUBSCRIBERS - - 获取单个订阅者的营销活动参与记录 [可选]
MAILCHIMP_GET_SUBSCRIBER_EMAIL_ACTIVITY - - 检索营销活动的HTML内容 [可选]
MAILCHIMP_GET_CAMPAIGN_CONTENT
MAILCHIMP_LIST_CAMPAIGNS的关键参数:
- : "save", "paused", "schedule", "sending", "sent"
status - /
count: 分页参数 (默认10, 最大1000)offset - /
since_send_time: ISO 8601格式的日期范围筛选before_send_time - : "create_time" or "send_time"
sort_field - : 限制响应字段以提升性能
fields
MAILCHIMP_GET_CAMPAIGN_REPORT的关键参数:
- : 营销活动ID (必填)
campaign_id - 返回内容:打开次数、点击次数、退信、退订、时间序列、行业统计数据
注意事项:
- 仅返回高级别的
MAILCHIMP_LIST_CAMPAIGNS;如需详细指标,请使用report_summaryMAILCHIMP_GET_CAMPAIGN_REPORT - 草稿/未发送的营销活动没有有意义的报告数据
- 在LIST_CAMPAIGNS上使用参数时,请显式请求
fields和send_time子字段report_summary - 分页默认值较低(10条记录);请使用和
count进行迭代,直到覆盖offsettotal_items - 是带时区的ISO 8601格式字符串;请仔细解析
send_time
Common Patterns
通用模式
ID Resolution
ID解析
Always resolve names to IDs before operations:
- Audience name -> list_id: and match by name
MAILCHIMP_GET_LISTS_INFO - Subscriber email -> subscriber_hash: Compute MD5 of lowercase email in code
- Campaign name -> campaign_id: with query
MAILCHIMP_SEARCH_CAMPAIGNS - Segment name -> segment_id: with list_id
MAILCHIMP_LIST_SEGMENTS
在操作前请始终将名称解析为ID:
- 受众名称 -> list_id:使用并按名称匹配
MAILCHIMP_GET_LISTS_INFO - 订阅者邮箱 -> subscriber_hash:在代码中计算邮箱小写形式的MD5哈希值
- 营销活动名称 -> campaign_id:使用并传入查询词
MAILCHIMP_SEARCH_CAMPAIGNS - 细分群体名称 -> segment_id:使用并传入list_id
MAILCHIMP_LIST_SEGMENTS
Pagination
分页
Mailchimp uses offset-based pagination:
- Use (page size, max 1000) and
count(skip N records)offset - Continue until collected records match from the response
total_items - Default is 10; always set explicitly for bulk operations
count - Search endpoints max at 10 pages (300 results for 30/page)
Mailchimp使用基于偏移量的分页:
- 使用(每页大小, 最大1000) 和
count(跳过N条记录)offset - 持续迭代直到收集的记录数与响应中的匹配
total_items - 默认为10;批量操作时请始终显式设置
count - 搜索端点最多返回10页 (每页30条共300条结果)
Subscriber Hash
订阅者哈希值
Many endpoints require (MD5 of lowercase email):
subscriber_hashimport hashlib
subscriber_hash = hashlib.md5(email.lower().encode()).hexdigest()许多端点需要 (邮箱小写形式的MD5哈希值):
subscriber_hashimport hashlib
subscriber_hash = hashlib.md5(email.lower().encode()).hexdigest()Known Pitfalls
已知注意事项
ID Formats
ID格式
- (audience ID) is a short alphanumeric string (e.g., "abc123def4")
list_id - is an alphanumeric string
campaign_id - is an MD5 hex string (32 characters)
subscriber_hash - Segment IDs are integers
- (受众ID) 是短字母数字字符串 (例如"abc123def4")
list_id - 是字母数字字符串
campaign_id - 是32字符的MD5十六进制字符串
subscriber_hash - 细分群体ID是整数
Rate Limits
速率限制
- Mailchimp enforces API rate limits; use batching for bulk subscriber operations
- High-volume use of GET_MEMBER_INFO and ADD_OR_UPDATE_LIST_MEMBER can trigger throttling
- Use for bulk segment operations
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
- Mailchimp对API调用有速率限制;批量订阅者操作请使用批处理方式
- 大量使用GET_MEMBER_INFO和ADD_OR_UPDATE_LIST_MEMBER可能会触发限流
- 批量细分群体操作请使用
MAILCHIMP_BATCH_ADD_OR_REMOVE_MEMBERS
Parameter Quirks
参数特性
- Nested parameters use double-underscore notation: ,
settings__subject__linerecipients__list__id - and
avg_open_rateare 0-1 fractions, not percentagesavg_click_rate - only applies to new contacts in upsert operations
status_if_new - must be MD5 of lowercase email; wrong casing creates phantom records
subscriber_hash - Campaign is required for creation; most common is "regular"
type - returns HTTP 204 on success (no body)
MAILCHIMP_SEND_CAMPAIGN
- 嵌套参数使用双下划线表示:,
settings__subject__linerecipients__list__id - 和
avg_open_rate是0-1的小数,而非百分比avg_click_rate - 仅适用于插入更新操作中的新联系人
status_if_new - 必须是邮箱小写形式的MD5哈希值;错误的大小写会导致无效记录
subscriber_hash - 创建营销活动时是必填项;最常用的是"regular"
type - 成功时返回HTTP 204 (无响应体)
MAILCHIMP_SEND_CAMPAIGN
Content and Compliance
内容与合规性
- Campaign HTML must include unsubscribe link and physical address (merge tags)
- Content must be set via before sending
MAILCHIMP_SET_CAMPAIGN_CONTENT - Test emails require campaign to have content already set
- 营销活动HTML必须包含退订链接和物理地址 (合并标签)
- 发送前必须通过设置内容
MAILCHIMP_SET_CAMPAIGN_CONTENT - 发送测试邮件要求营销活动已设置好内容
Quick Reference
快速参考
| Task | Tool Slug | Key Params |
|---|---|---|
| List audiences | | |
| Get audience details | | |
| Create campaign | | |
| Set campaign content | | |
| Send test email | | |
| Send campaign | | |
| Schedule campaign | | |
| Get campaign info | | |
| Search campaigns | | |
| List campaigns | | |
| Replicate campaign | | |
| List subscribers | | |
| Search members | | |
| Get member info | | |
| Add subscriber | | |
| Upsert subscriber | | |
| Batch members | | |
| List segments | | |
| Campaign report | | |
| All reports | | |
| Link click details | | |
| Subscriber activity | | |
| Member recent activity | | |
| Campaign content | | |
| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 列出受众 | | |
| 获取受众详情 | | |
| 创建营销活动 | | |
| 设置营销活动内容 | | |
| 发送测试邮件 | | |
| 发送营销活动 | | |
| 安排营销活动发送时间 | | |
| 获取营销活动信息 | | |
| 搜索营销活动 | | |
| 列出营销活动 | | |
| 复制营销活动 | | |
| 列出订阅者 | | |
| 搜索成员 | | |
| 获取成员信息 | | |
| 添加订阅者 | | |
| 插入更新订阅者 | | |
| 批量管理成员 | | |
| 列出细分群体 | | |
| 营销活动报告 | | |
| 获取所有报告 | | |
| 链接点击详情 | | |
| 订阅者活动记录 | | |
| 成员近期活动 | | |
| 营销活动内容 | | |