Mcp Sendgrid

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for SendGrid — global transactional + marketing email (Twilio-owned)

已驗證STDIO僅桌面溝通與協作商業與電商

概覽

AI 產生的概覽

讓助理透過 SendGrid 寄送交易型與行銷郵件，並管理聯絡人、名單、範本、抑制名單與統計資料。

可以做什麼
包裝 SendGrid v3 API，提供約 20 個工具。可寄送一般郵件與動態範本郵件，新增、搜尋、列出與刪除 Marketing Campaigns 聯絡人與名單，管理交易型範本、抑制群組與退信，取消已排程的寄送，讀取事件 Webhook 設定，並取得全域郵件統計。
適用情境
適合讓助理寄送訂單確認、物流更新或促銷郵件，或直接維護 SendGrid 聯絡人名單與抑制資料。適用於已採用 SendGrid 的通知與行銷流程。
執行需求
以 stdio 方式在使用者本機執行，通常透過 npm 套件 @codespar/mcp-sendgrid 以 npx 啟動，因此需要 Node.js。需要 SENDGRID_API_KEY 中的 SendGrid API 金鑰；SENDGRID_FROM_EMAIL 是選用的預設寄件者，必須是已驗證寄件者或屬於已驗證網域。需要連線至 api.sendgrid.com 的網路存取。
安裝前請注意
SENDGRID_API_KEY 是授予帳戶層級存取權的密鑰權杖，請勿寫入日誌或共用設定。多個工具會寫入或刪除資料，包括寄送郵件、刪除聯絡人與名單、移除退信紀錄以及取消已排程寄送。寄送郵件與管理行銷聯絡人可能產生費用或違反同意規範，使用前請確認收件者與內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Sendgrid，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-sendgrid

MCP server for SendGrid — global transactional and marketing email.

SendGrid is Twilio-owned (acquired 2019). Together with @codespar/mcp-twilio this package closes the messaging loop:

  • Twilio — SMS, WhatsApp, Voice, Verify
  • SendGrid — email (transactional + marketing)

Agents building commerce notification flows — order confirmations, shipping updates, abandoned-cart nudges, promos — can now cover every channel through two packages.

Tools (20)

ToolPurpose
send_mailSend an email via POST /mail/send.
send_templateConvenience wrapper for POST /mail/send with a dynamic template.
add_contactUpsert contacts in Marketing Campaigns via PUT /marketing/contacts.
list_contactsList Marketing Campaigns contacts via GET /marketing/contacts.
delete_contactDelete contacts by id via DELETE /marketing/contacts?ids=....
search_contactsSearch contacts with an SGQL query via POST /marketing/contacts/search.
get_contactRetrieve a single Marketing Campaigns contact by id via GET /marketing/contacts/{id}.
list_listsList all Marketing Campaigns contact lists via GET /marketing/lists.
create_listCreate a Marketing Campaigns contact list via POST /marketing/lists.
delete_listDelete a Marketing Campaigns contact list via DELETE /marketing/lists/{id}.
list_templatesList transactional templates via GET /templates.
create_templateCreate a transactional template via POST /templates.
list_suppressionsList all suppressed recipients for an unsubscribe group via GET /asm/groups/{group_id}/suppressions.
add_suppressionAdd recipients to a suppression group via POST /asm/groups/{group_id}/suppressions.
list_unsubscribe_groupsList all unsubscribe groups on the account via GET /asm/groups.
get_bouncesRetrieve bounced recipients via GET /suppression/bounces.
delete_bounceRemove a bounced address from the bounce suppression list via DELETE /suppression/bounces/{email}.
cancel_scheduled_sendCancel or pause a scheduled send by batch_id via POST /user/scheduled_sends.
get_event_webhook_settingsRetrieve the Event Webhook configuration via GET /user/webhooks/event/settings.
get_statsGlobal email stats via GET /stats.

Install

bash
npm install @codespar/mcp-sendgrid

Environment

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

The SENDGRID_FROM_EMAIL must be either a Verified Sender or belong to an authenticated domain.

Authentication

Bearer-token auth. The server handles this automatically.

Authorization: Bearer <SENDGRID_API_KEY>

API surface

  • Base URL: https://api.sendgrid.com/v3
  • All requests/responses are application/json
  • POST /mail/send returns 202 Accepted on success (no body)

Send with a dynamic template

json
{  "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"  }}

Run

bash
# 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

Pairs with

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/communication/sendgrid/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分