MCP server
SendGrid MCP by usefulapi
Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About SendGrid MCP by usefulapi
SendGrid MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://sendgrid.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sendgrid": {
"url": "https://sendgrid.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"sendgrid": {
"type": "http",
"url": "https://sendgrid.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sendgrid": {
"serverUrl": "https://sendgrid.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sendgrid": {
"type": "http",
"url": "https://sendgrid.usefulapi.io/mcp"
}
}
}Tools this server provides (11)
Read directly from the server.
- sendgrid_ping
- Health check — verifies the API key works and returns the scopes (permissions) granted to it. SendGrid: GET /v3/scopes.
- sendgrid_list_templates
- List your transactional email templates (Dynamic and/or Legacy). Returns { result: [...], _metadata } — use _metadata.next / page_token to paginate. SendGrid: GET /v3/templates.
- sendgrid_get_template
- Get a single transactional email template by id, including its versions (subject + content). SendGrid: GET /v3/templates/{template_id}.
- sendgrid_list_marketing_lists
- List your Marketing Campaigns contact lists, each with its id, name, and contact_count. Returns { result: [...], _metadata }. SendGrid: GET /v3/marketing/lists.
- sendgrid_get_contact_count
- Get the total number of Marketing Campaigns contacts on your account. Returns { contact_count, billable_count }. SendGrid: GET /v3/marketing/contacts/count.
- sendgrid_search_contacts_by_email
- Look up marketing contacts by exact email address (a read-only lookup — mutates nothing). Returns { result: { "<email>": { contact: {...} } } }. SendGrid: POST /v3/marketing/contacts/search/emails.
- sendgrid_get_stats
- Get global email statistics over a date range (delivered, opens, clicks, bounces, spam reports, etc.). Returns an array of { date, stats: [{ metrics: {...} }] }. SendGrid: GET /v3/stats.
- sendgrid_list_bounces
- List bounced email addresses (the bounce suppression list). Returns an array of { created, email, reason, status }. SendGrid: GET /v3/suppression/bounces.
- sendgrid_list_global_unsubscribes
- List globally-unsubscribed email addresses (the global suppression list). Returns an array of { created, email }. SendGrid: GET /v3/suppression/unsubscribes.
- sendgrid_send_mail
- SENDS A REAL EMAIL immediately via SendGrid. Provide `from_email` and one or more `to` recipients, plus EITHER a subject + content OR a `template_id` (dynamic template ids start with "d-", pass values via dynamic_template_data). Returns { status: "accepted", message_id }. SendGrid: POST /v3/mail/send.
- sendgrid_add_or_update_contacts
- UPSERTS marketing contacts (creates new ones, updates existing ones by email) and optionally adds them to lists. This is an ASYNC job — returns { job_id } you can poll. SendGrid: PUT /v3/marketing/contacts.
SendGrid MCP by usefulapi FAQ
How do I add SendGrid MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcp