Aerostack
electrical_services

SendGrid MCP Server — Hosted Notifications Integration

MCP Server language Hosted language Public

Send emails at scale, manage dynamic templates, and track delivery stats via SendGrid's email infrastructure.

aerostack @aerostack verified
v0.1.0 MIT Updated Jun 28, 2026
robot_2

Use with AI AssistantsMCP

Connect Claude, Cursor, or any MCP-compatible client — then call tools directly

① Add This MCP Server

Paste into your AI client config — then all its tools are available instantly.

.claude/mcp.json
{
  "mcpServers": {
    "sendgrid": {
      "url": "https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid",
      "headers": {
        "Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
      }
    }
  }
}

Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.

② Call a Tool

Ask your AI assistant to call a specific tool, or send raw JSON-RPC:

+15 more

Natural Language Prompt

“Use the _ping tool to verify sendgrid credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials

Using a Workspace?

Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.

add_circleAdd to Workspace

description Overview

mcp-sendgrid — SendGrid MCP Server

Send transactional and marketing emails at scale — let AI agents trigger emails, manage templates, maintain contact lists, and monitor deliverability via SendGrid.

SendGrid powers email delivery for over 80,000 companies, sending billions of emails every month. This MCP server gives your agents the full SendGrid v3 API: sending single and bulk emails with dynamic templates, managing marketing contacts and lists, pulling delivery and engagement stats, monitoring bounces, and managing verified sender identities.

Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid


What You Can Do

  • Send transactional emails from any trigger — signups, payments, errors, or alerts — with dynamic template data
  • Send personalized bulk emails to thousands of recipients with per-recipient template variables
  • Monitor email deliverability with global stats, bounce lists, and per-template analytics
  • Maintain marketing contact lists and sync subscribers from your application automatically

Available Tools

Tool Description
send_email Send a transactional email with HTML/text content, CC, BCC, and dynamic template support
send_bulk_email Send to multiple recipients with per-recipient dynamic template data (up to 1000)
send_template_email Simplified tool to send a dynamic template email with substitution data
schedule_email Schedule an email to send at a specific Unix timestamp (up to 72 hours ahead)
list_templates List all dynamic transactional email templates
get_template Get full details of a template including all versions
create_template Create a new dynamic transactional email template
get_template_version Get a specific template version with HTML content and subject
search_contacts Search marketing contacts using SGQL query language
get_contact Get full details of a marketing contact by ID
upsert_contacts Create or update one or more marketing contacts by email
list_contact_lists List all marketing contact lists
add_contacts_to_list Add contacts to a specific marketing list by contact ID
get_global_stats Get global email stats (sends, opens, clicks, bounces) for a date range
get_email_stats Get stats filtered by category for a date range
get_template_stats Get delivery and engagement stats for a specific template version
get_bounce_list Get bounced email addresses with reason and timestamp
list_senders List all verified sender identities
create_sender Create a new sender identity (requires email verification)
verify_sender_domain Validate DNS records (DKIM, SPF) for an authenticated domain

Configuration

Variable Required Description How to Get
SENDGRID_API_KEY Yes SendGrid API key with Mail Send and Marketing permissions app.sendgrid.com → Settings → API Keys → Create API Key

Quick Start

Add to Aerostack Workspace
  1. Go to aerostack.dev → Your Project → MCPs
  2. Search for "SendGrid" and click Add to Workspace
  3. Add your SENDGRID_API_KEY under Project → Secrets

Once added, every AI agent in your workspace can send and manage emails via SendGrid automatically — no per-user setup needed.

Example Prompts
"Send a welcome email to new user alice@example.com using template d-abc123 with her first name 'Alice'"
"Show me the email open rate and click rate for the past 7 days"
"Sync the new customer list and add all emails to the 'Active Customers' marketing list"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid \
  -H 'Content-Type: application/json' \
  -H 'X-Mcp-Secret-SENDGRID-API-KEY: your-key' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"send_email","arguments":{"to":"alice@example.com","from":"hello@yourapp.com","subject":"Welcome!","content":[{"type":"text/plain","value":"Thanks for signing up!"}]}}}'

License

MIT

terminal Tools (21)

Available tools on this MCP server. Each tool can be called directly from any AI agent.

terminal
_ping #1

Verify SendGrid credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.

terminal
send_email #2

Send a transactional email via SendGrid. Supports plain text and HTML content, CC, BCC, reply-to, dynamic templates, and custom template data.

terminal
send_bulk_email #3

Send the same email to multiple recipients using personalizations. Each recipient can have unique dynamic_template_data. Supports up to 1000 recipients per call.

terminal
send_template_email #4

Simplified tool to send an email using a SendGrid dynamic template. Just provide the template ID, recipient, sender, and template data.

terminal
schedule_email #5

Schedule an email to be sent at a specific future time. Uses a Unix timestamp for the send_at field. SendGrid allows scheduling up to 72 hours in advance.

terminal
list_templates #6

List all dynamic transactional email templates in your SendGrid account.

terminal
get_template #7

Get full details of a specific SendGrid template including all versions.

terminal
create_template #8

Create a new dynamic transactional email template in SendGrid.

terminal
get_template_version #9

Get a specific version of a template, including the HTML/text content and subject.

terminal
search_contacts #10

Search your SendGrid marketing contacts using SGQL (SendGrid Query Language). Supports filtering by email, first_name, last_name, custom fields, and list membership.

terminal
get_contact #11

Get full details of a specific contact by their SendGrid contact ID.

terminal
upsert_contacts #12

Create or update (upsert) one or more marketing contacts. If a contact with the email already exists, it is updated; otherwise it is created. Asynchronous — returns a job_id.

terminal
list_contact_lists #13

List all contact lists (segments/audiences) in your SendGrid Marketing account.

terminal
add_contacts_to_list #14

Add one or more contacts (by their contact IDs) to a specific marketing list.

terminal
get_global_stats #15

Get global email statistics (sends, deliveries, opens, clicks, bounces, spam reports) across all emails for a date range.

terminal
get_email_stats #16

Get email statistics filtered by category for a date range.

terminal
get_template_stats #17

Get delivery and engagement statistics for a specific template version.

terminal
get_bounce_list #18

Get the list of email addresses that have bounced. Includes bounce reason and timestamp.

terminal
list_senders #19

List all verified sender identities in your SendGrid account. Shows verification status.

terminal
create_sender #20

Create a new sender identity in SendGrid. The sender must complete email verification before it can be used to send emails.

terminal
verify_sender_domain #21

Trigger domain authentication validation for a whitelabeled domain. Checks that DNS records (DKIM, SPF) are correctly configured.

Details

upgrade Version 0.1.0
gavel License MIT
wifi Transport streamable-http
lock Access Public
category Category Notifications
terminal Tools 21

language Live Endpoint

https://mcp.aerostack.dev/s/aerostack/mcp-sendgrid

Sub-50ms globally · Zero cold start

Publisher

aerostack
@aerostack verified

Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.

Tags

Browse more servers

More in Notifications

Browse Notifications MCPs →

Frequently asked questions

What is the SendGrid MCP server and what can it do? +

The SendGrid MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `send_email`, `send_bulk_email`, `send_template_email`, `schedule_email`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.

Is the SendGrid MCP server hosted, or do I have to run it myself? +

It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.

Which AI agents and editors can use the SendGrid MCP server? +

Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same SendGrid MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.

How do I install the SendGrid MCP server in Claude Desktop? +

Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-sendgrid": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-sendgrid"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.

How do I use the SendGrid MCP server in Cursor? +

In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-sendgrid", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-sendgrid"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.

Does SendGrid MCP require authentication? +

Yes. SendGrid requires authentication. Check the MCP's documentation for the required credentials.