mcp-sendgrid

@codespar/mcp-sendgrid

适用于 SendGrid 的 MCP 服务 — 全球事务性和营销电子邮件。

SendGrid 由 Twilio 所有（于 2019 年收购）。与 @codespar/mcp-twilio 搭配使用，此包可打通消息发送的完整链路：

• Twilio — SMS、WhatsApp、语音、Verify
• SendGrid — 电子邮件（事务性 + 营销）

构建电商通知工作流的 Agent — 订单确认、发货更新、购物车弃购提醒、促销信息 — 现在可以通过两个包覆盖所有渠道。

工具（20）

工具	用途
send_mail	通过 POST /mail/send 发送电子邮件。
send_template	便捷封装，通过 POST /mail/send 使用动态模板。
add_contact	通过 PUT /marketing/contacts 在 Marketing Campaigns 中新增或更新联系人。
list_contacts	通过 GET /marketing/contacts 列出 Marketing Campaigns 联系人。
delete_contact	通过 DELETE /marketing/contacts?ids=.... 按 ID 删除联系人。
search_contacts	通过 POST /marketing/contacts/search 使用 SGQL 查询搜索联系人。
get_contact	通过 GET /marketing/contacts/{id} 按 ID 获取单个 Marketing Campaigns 联系人。
list_lists	通过 GET /marketing/lists 列出所有 Marketing Campaigns 联系人列表。
create_list	通过 POST /marketing/lists 创建 Marketing Campaigns 联系人列表。
delete_list	通过 DELETE /marketing/lists/{id} 删除 Marketing Campaigns 联系人列表。
list_templates	通过 GET /templates 列出事务性模板。
create_template	通过 POST /templates 创建事务性模板。
list_suppressions	通过 GET /asm/groups/{group_id}/suppressions 列出退订组中的所有受抑制收件人。
add_suppression	通过 POST /asm/groups/{group_id}/suppressions 将收件人添加到抑制组。
list_unsubscribe_groups	通过 GET /asm/groups 列出账户中的所有退订组。
get_bounces	通过 GET /suppression/bounces 获取退信收件人。
delete_bounce	通过 DELETE /suppression/bounces/{email} 从退信抑制列表中移除退信地址。
cancel_scheduled_send	通过 POST /user/scheduled_sends，按 batch_id 取消或暂停计划发送。
get_event_webhook_settings	通过 GET /user/webhooks/event/settings 获取 Event Webhook 配置。
get_stats	通过 GET /stats 获取全局电子邮件统计信息。

安装

npm install @codespar/mcp-sendgrid

环境变量

SENDGRID_API_KEY="SG...."         # required (secret)
SENDGRID_FROM_EMAIL="[email protected]"   # optional default sender

SENDGRID_FROM_EMAIL 必须是已验证的发件人，或属于经过身份验证的域名。

身份验证

使用 Bearer 令牌进行身份验证。服务会自动处理。

Authorization: Bearer <SENDGRID_API_KEY>

API 概览

• 基础 URL：https://api.sendgrid.com/v3
• 所有请求和响应均为 application/json
• 成功时，POST /mail/send 返回 202 Accepted（无响应正文）

使用动态模板发送

{
  "to": "[email protected]",
  "template_id": "d-abc123...",
  "dynamic_template_data": {
    "order_id": "1001",
    "total_brl": "R$ 249,90",
    "tracking_url": "https://example.com/track/1001"
  }
}

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-sendgrid

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sendgrid

搭配使用

• @codespar/mcp-twilio — SMS、WhatsApp、语音、Verify、Lookup

企业版

需要为 Agent 付款实现治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

许可证

MIT