用途:借助 Composio 的 SendGrid 工具包,通过 Rube MCP 自动化 SendGrid 邮件投递流程,涵盖营销活动(Single Sends)、联系人与列表管理、发件人身份设置和邮件分析。
主要能力与用法:
- 营销活动:列出列表(SENDGRID_RETRIEVE_ALL_LISTS)、创建列表、添加联系人、获取已验证发件人身份、创建 Single Send(SENDGRID_CREATE_SINGLE_SEND)。参数包括 name、email__config__subject、email__config__html__content、email__config__plain__content、email__config__sender__id、send__to__list__ids 等;必须提供 suppression_group_id 或 custom_unsubscribe_url。注意:CREATE 上的 send_at 不会真正排期,需用 Schedule 端点;send_at "now" 仅对 Schedule 有效。
- 联系人与列表:创建列表、按 ID 查列表、增改联系人(SENDGRID_ADD_OR_UPDATE_A_CONTACT,最多 30000 条或 6MB)、按邮箱/标识符查联系人、统计列表人数、从列表移除、删除列表、CSV 批量导入。联系人操作异步(返回 202 与 job_id,需等待 10-30 秒验证);列表 ID 为 UUID;列表名唯一。
- 发件人身份:获取、创建、查看、更新发件人身份,创建并验证发件人,域名认证。新发件人须验证;每账户最多 100 个身份;避免使用严格 DMARC 域名。
- 邮件统计:全局统计、按分类统计、按收件人/状态/日期过滤活动、按 message_id 查详情、导出 CSV。注意:过滤活动需付费附加组件;分类统计仅过去 13 个月;每请求最多 10 个分类;CSV 每 12 小时一次,链接 3 天过期。
- 抑制管理:列出抑制组、检查邮箱抑制状态。被抑制地址不可投递。
前置条件:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 激活 sendgrid 连接;先调用 RUBE_SEARCH_TOOLS 获取最新工具模式。设置:将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;按返回的授权链接完成 SendGrid API 密钥认证。
限制:可能遇到 HTTP 429,需遵循 Retry-After;嵌套参数用双下划线写法;部分旧版 Contact Database API 在新账户可能返回 403,优先使用 Marketing API 工具。