SuperAPI AI 工具集

sendgrid-automation

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:通过 Rube MCP(Composio 的 SendGrid 工具包)自动化 SendGrid 邮件操作,覆盖营销活动(Single Sends)、联系人与列表管理、发件人身份设置及邮件分析。

主要能力:

  1. 创建并发送营销活动:先列出列表(SENDGRID_RETRIEVE_ALL_LISTS)、获取已验证发件人(SENDGRID_GET_ALL_SENDER_IDENTITIES),再用 SENDGRID_CREATE_SINGLE_SEND 创建活动。关键参数含 name、email__config__subject、email__config__html__content、email__config__sender__id、send__to__list__ids 等;合规上需提供 suppression_group_id 或 custom_unsubscribe_url。注意 send_at 在创建时不会真正排期,需另用 Schedule 端点。
  2. 联系人与列表:创建列表、增改联系人(SENDGRID_ADD_OR_UPDATE_A_CONTACT,单次最多 30000 条或 6MB)、按邮箱或标识符查询、移除联系人、删除列表、CSV 批量导入。联系人操作异步,返回 202 与 job_id,需等待 10-30 秒再验证。
  3. 发件人身份:列出、创建、查看、更新发件人,创建验证请求及域名认证。新发件人须验证后才能使用,每账户最多 100 个。
  4. 统计与活动:全局统计、按类别统计、按收件人/状态/日期筛选邮件活动、导出 CSV。筛选活动需付费附加组件,否则返回 403;CSV 导出每 12 小时限一次,链接 3 天后过期。
  5. 抑制管理:查看抑制组及特定邮箱的抑制状态。

使用方式:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,确认 RUBE_SEARCH_TOOLS 可用;调用 RUBE_MANAGE_CONNECTIONS 并选择 sendgrid 工具包,若未激活则按返回的授权链接完成 API Key 认证,状态为 ACTIVE 后使用。每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。

限制:列表 ID 为 UUID,发件人 ID 为整数,模板 ID 动态模板以 d- 开头;嵌套参数用双下划线;可能返回 429,需遵循 Retry-After;部分旧版 Contact Database API 工具在新账户可能返回 403,建议优先使用 Marketing API 工具。删除列表不可逆,需用户确认。