mcp-sendgrid

@codespar/mcp-sendgrid

SendGrid 向け MCP サーバー — グローバルなトランザクションメールとマーケティングメール。

SendGrid は Twilio が所有しています（2019 年に買収）。@codespar/mcp-twilio と組み合わせることで、このパッケージはメッセージングのループを完結させます。

• Twilio — SMS、WhatsApp、音声、認証
• SendGrid — メール（トランザクションメール＋マーケティングメール）

注文確認、配送状況の更新、カート放棄へのリマインダー、プロモーションなど、コマースの通知ワークフローを構築するエージェントは、2 つのパッケージであらゆるチャネルをカバーできるようになります。

ツール（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 の連絡先を 1 件取得します。
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 は、Verified Sender であるか、認証済みドメインに属している必要があります。

認証

ベアラートークン認証です。サーバーが自動的に処理します。

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、音声、認証、Lookup

エンタープライズ

エージェントによる支払いに、ガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT