GS

garoth/sendgrid-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

32 stars 20 forks 质量 58 趋势 11

允许 AI 代理与 Twilio SendGrid v3 API 交互,管理联系人列表、模板、单次发送和统计数据

概览

一个模型上下文协议(MCP)服务器,提供访问SendGrid营销API以进行电子邮件营销和联系管理。https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api 在这个演示中,我们要求Cline SendGrid代理创建新的联系人列表,添加我的邮件,自动生成失落之城事实模板,并将邮件发送到名单中。在这个过程中,Cline会自动意识到需要知道我们已验证的发件人,以及使用哪个退订组。一封漂亮的邮件送到我的收件箱,让我对失落之城感到非常高兴! 该服务器仅支持 SendGrid 的 v3 API,不支持遗留功能。包括: - 仅支持动态模板 - 不支持遗留模板 - 所有联系人和联系人名单操作的Marketing API v3 - 批量发送邮件的单一发送API 列出你SendGrid账户中的所有联系人。 将联系人添加到您的SendGrid营销联系人中。

概述(AI 翻译)

一个模型上下文协议(MCP)服务器,提供访问SendGrid营销API以进行电子邮件营销和联系管理。https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api

演示

在这个演示中,我们要求Cline SendGrid代理创建新的联系人列表,添加我的邮件,自动生成失落之城事实模板,并将邮件发送到名单中。在这个过程中,Cline会自动意识到需要知道我们已验证的发件人,以及使用哪个退订组。一封漂亮的邮件送到我的收件箱,让我对失落之城感到非常高兴!

关于API支持的重要说明

该服务器仅支持 SendGrid 的 v3 API,不支持遗留功能。包括:

  • 仅支持动态模板——不支持遗留模板
  • 适用于所有联系人和联系人名单操作的营销API v3
  • 单发发送 API 用于批量邮件发送

可用工具

联系管理层

list_contacts

列出你SendGrid账户中的所有联系人。

####add_contact 将联系人添加到您的SendGrid营销联系人中。

####delete_contacts 删除你的SendGrid账户中的联系人。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

SendGrid MCP Server

A Model Context Protocol (MCP) server that provides access to SendGrid’s Marketing API for email marketing and contact management. https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api

Demo

In this demo, we ask the Cline SendGrid agent to make a new contact list, add my emails to it, automatically generate a template for Lost Cities facts, and send the email to the list. In this process, Cline will automatically realize that it needs to know the verified senders we have, and which unsubscribe group to use. A pretty email is delivered to my inboxes, delighting me with Lost Cities!

Important Note on API Support

This server exclusively supports SendGrid’s v3 APIs and does not provide support for legacy functionality. This includes:

  • Dynamic templates only - legacy templates are not supported
  • Marketing API v3 for all contact & contact list operations
  • Single Sends API for bulk email sending

Available Tools

Contact Management

list_contacts

Lists all contacts in your SendGrid account.

// No parameters required

add_contact

Add a contact to your SendGrid marketing contacts.

{
  email: string;           // Required: Contact email address
  first_name?: string;     // Optional: Contact first name
  last_name?: string;      // Optional: Contact last name
  custom_fields?: object;  // Optional: Custom field values
}

delete_contacts

Delete contacts from your SendGrid account.

{
  emails: string[];  // Required: Array of email addresses to delete
}

get_contacts_by_list

Get all contacts in a SendGrid list.

{
  list_id: string;  // Required: ID of the contact list
}

List Management

list_contact_lists

List all contact lists in your SendGrid account.

// No parameters required

create_contact_list

Create a new contact list in SendGrid.

{
  name: string;  // Required: Name of the contact list
}

delete_list

Delete a contact list from SendGrid.

{
  list_id: string;  // Required: ID of the contact list to delete
}

add_contacts_to_list

Add contacts to an existing SendGrid list.

{
  list_id: string;    // Required: ID of the contact list
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "sendgrid": { "command": "node", "args": ["/path/to/sendgrid-mcp/build/index.js"], "env": { "SENDGRID_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [ "list_contacts", "list_contact_lists", "list_templates", "list_single_sends", "get_single_send", "list_verified_senders", "list_suppression_groups", "get_stats", "validate_email" ] } } }