MCP.Market

SendGrid Transactional MCP server

by Neschadin·io.github.Neschadin/sendgrid-mcp·v3.0.3·1 stars

SendGrid transactional email: preflight send, templates, and delivery diagnostics.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

1 stars566 downloads/wk

Reviews

Write one

Nobody has reviewed SendGrid Transactional yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

SendGrid Transactional tools (78, 35 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • activate_template_version

    Activate a specific version of a template (only one version can be active at a time)

  • analyze_engagement_anomalies

    Analyze Event Webhook events for non-human engagement patterns, machine opens, and unique-open approximation.

  • cancel_scheduled_sendwrite action

    Cancel a scheduled send batch. This is not guaranteed close to send time.

  • check_suppression

    Check bounce, block, global unsubscribe, spam report, invalid email, and ASM group suppressions (GET /v3/asm/suppressions/{email}) for one recipient.

  • classify_sendgrid_error

    Classify SendGrid API errors and return likely causes with targeted remediation steps.

  • clear_received_webhook_events

    Clear locally captured SendGrid Event Webhook payloads.

  • create_alertwrite action

    Create a SendGrid alert (usage_limit or stats_notification).

  • create_asm_groupwrite action

    Create an ASM unsubscribe group (POST /v3/asm/groups) for transactional mail. Does not create a marketing list.

  • create_authenticated_domainwrite action

    Start domain authentication (whitelabel domain). Returns DNS records to configure.

  • create_batch_idwrite action

    Create a SendGrid batch ID for scheduled sends and later pause/cancel control.

  • create_inbound_parse_settingwrite action

    Create inbound parse setting. Hostname MX must point to SendGrid.

  • create_templatewrite action

    Create a new dynamic template with a first version

  • create_verified_senderwrite action

    Create a verified sender identity. SendGrid emails a verification link to from_email.

  • delete_alertwrite action

    Delete a SendGrid alert by ID.

  • delete_inbound_parse_settingwrite action

    Delete inbound parse setting by hostname.

  • delete_suppressionwrite action

    Remove one recipient from a suppression list: bounce, block, spam_report, invalid_email, global unsubscribe, or one ASM group. Does not delete the group itself.

  • delete_templatewrite action

    Permanently delete a SendGrid template and all its versions. Use with caution.

  • delete_verified_senderwrite action

    Delete a verified sender identity by ID.

  • get_account_info

    Read SendGrid account overview (account type, reputation, and related metadata).

  • get_alert

    Read one SendGrid alert by ID.

  • get_authenticated_domain

    Read one authenticated domain record by ID.

  • get_branded_link

    Read one branded link record by ID.

  • get_email_statswrite action

    Get email statistics. dimension=global is the account daily rollup. category requires categories. mailbox_provider, geo, browser, device, and client are the other SendGrid stats cuts. Browser, device, and client stats retain about 7 days.

  • get_enforced_tls

    Read Enforced TLS settings (GET /v3/user/settings/enforced_tls). require_tls drops mail when the recipient MX does not offer TLS.

  • get_event_webhook

    Get one Event Webhook config by ID from SendGrid.

  • get_mail_setting

    Read one SendGrid mail setting by name.

  • get_message_activity

    Get Email Activity for one message. msgId may be a full msg_id or the Mail Send x-message-id (resolved with msg_id LIKE). On Activity 403/404 for a full id, falls back to POST /v3/logs.

  • get_received_webhook_events

    Read recent Event Webhook payloads captured by this server (for SendGrid-side diagnostics).

  • get_scheduled_sendwrite action

    Read pause/cancel state for one scheduled-send batch_id. SendGrid answers a missing batch with 200 and an empty array; this tool reports that as not found.

  • get_scopes

    List OAuth scopes granted to the current SendGrid API key (GET /v3/scopes). Use this after a 403 to see what the key can actually call.

  • get_template_html

    Get full HTML content of a template's active (or specific) version

  • get_tracking_setting

    Read one SendGrid tracking setting by name.

  • get_user_credits

    Read SendGrid account email credits/quota overview.

  • get_user_profile

    Read SendGrid user profile (company, address, contact fields).

  • get_verified_sender

    Read one verified sender identity by ID.

  • get_webhook_receiver_status

    Show local webhook receiver status for incoming SendGrid Event Webhook posts.

  • list_alerts

    List SendGrid account alerts (usage limits and stats notifications).

  • list_asm_groups

    List ASM unsubscribe groups (GET /v3/asm/groups). Use the id as asm.groupId when sending. This is not a marketing contact list.

  • list_authenticated_domains

    List domain authentication (whitelabel domain) records and DNS validation state.

  • list_branded_links

    List link branding (click-tracking domain) records.

  • list_categories

    List category names (GET /v3/categories) so get_email_stats dimension=category can be given a real categories array.

  • list_event_webhooks

    List all Event Webhook configurations directly from SendGrid.

  • list_inbound_parse_settings

    List inbound parse (receive email webhook) settings.

  • list_mail_settings

    List SendGrid mail settings summaries (footer, bounce purge, spam check, etc.).

  • list_scheduled_sends

    List paused or canceled scheduled-send batches (GET /v3/user/scheduled_sends). A batch that was only scheduled with send_at, and never paused or canceled, is not in this list.

  • list_subusers

    List SendGrid subusers for the parent API key (GET /v3/subusers). Use a returned username as onBehalfOf on later calls, or as SENDGRID_ON_BEHALF_OF. Pass onBehalfOf="parent" when that env var is already set and this list must run as the parent.

  • list_suppressions

    List SendGrid suppressions by type (bounces, blocks, unsubscribes, spam reports, invalid emails, global unsubscribes).

  • list_templates

    List all dynamic SendGrid templates with their IDs, names, and version counts

  • list_tracking_settings

    List SendGrid tracking settings summaries (click, open, subscription, etc.).

  • list_verified_senders

    List verified sender identities configured in SendGrid.

  • manage_event_webhookwrite action

    Create, delete, or test a SendGrid Event Webhook. create requires url. delete requires id. test sends a sample event to url, or to the saved webhook url when only id is set.

  • pause_scheduled_sendwrite action

    Pause a scheduled send batch by batch ID.

  • prune_inactive_template_versionswrite action

    Delete all inactive versions for one or more templates (keeps the active version only)

  • rename_template

    Rename a dynamic template (updates the template name, not a version label)

  • rename_templates_bulk

    Bulk rename templates by ID and/or current name. Supports dry-run and stop-on-error.

  • resend_verified_sender_verification

    Resend verification email for a verified sender identity.

  • resume_scheduled_sendwrite action

    Resume a previously paused/canceled batch by deleting its scheduled-send status.

  • schedule_emailwrite action

    Schedule an email by setting send_at. Creates batch ID automatically when not provided.…

  • search_email_logswrite action

    Search Email Logs (POST /v3/logs). Use when Email Activity is unavailable, especially for EU regional subusers. Query fields: sg_message_id =, subject =, to_email =, status IN, reason =, categories IN, sg_message_id_created_at comparisons. Combine with AND. No nesting. Parent accounts pass exactly one subuser.

  • search_message_activity

    Search SendGrid Email Activity (GET /v3/messages). Pass xMessageId for the Mail Send x-message-id header; it is compiled to msg_id LIKE. offset is not supported by this API. On 403/404, or an empty EU Activity result, falls back to POST /v3/logs.

  • send_email_advancedwrite action

    Send email with full /mail/send payload surface (content/template, tracking, asm, scheduling, categories, etc).…

  • send_sandbox_emailwrite action

    Send using mail_settings.sandbox_mode=true for payload/template validation without live recipient delivery.…

  • send_template_email_advancedwrite action

    Send a dynamic-template email with optional cc/bcc, reply-to, asm, categories, custom args, and scheduling.…

  • send_test_emailwrite action

    Send a test email using a template with mock data. Uses mail_settings.sandbox_mode by default (SendGrid accepts but does not deliver). Set liveDelivery=true with confirmToken="CONFIRM" for real delivery.

  • send_with_preflightwrite action

    Preferred production send path: runs validate_send_request checks first, then POST /v3/mail/send only when no blockers (and optionally no warnings with abortOnWarnings). Use validate_send_request alone for a dry-run review before calling send_email_advanced or send_template_email_advanced.

  • sync_template_ids
  • toggle_event_webhook_signature

    Enable or disable SendGrid signature verification for a specific Event Webhook.

  • triage_delivery_issuewrite action

    Run targeted delivery triage for common incidents (202 accepted no inbox, processing, sender identity, DMARC/auth, template drops, deferrals, unsubscribe spikes).

  • update_alertwrite action

    Update an existing SendGrid alert by ID.

  • update_branded_linkwrite action

    Update a branded link (e.g. set default=true for click-tracking domain).

  • update_event_webhookwrite action

    Update Event Webhook settings in SendGrid (URL, enabled flag, and event toggles).

  • update_inbound_parse_settingwrite action

    Update inbound parse setting for a hostname.

  • update_mail_settingwrite action

    Update one SendGrid mail setting (PATCH /mail_settings/{name}). Payload fields depend on setting type.

  • update_template_htmlwrite action

    Update the HTML, subject, or name of a specific template version

  • update_tracking_settingwrite action

    Update one SendGrid tracking setting (click/open/subscription/google_analytics).

  • validate_authenticated_domain

    Validate DNS for an authenticated domain. Returns validation results and errors.

  • validate_branded_link

    Validate DNS for a branded link (click-tracking domain) by ID.

  • validate_send_requestwrite action

    Run this before any send_* call. Validates /v3/mail/send payload shape, active dynamic template, sender identity (domain authentication or verified sender), link branding alignment, recipient suppressions, and scheduling limits (send_at must be in the future and within 72 hours per SendGrid Mail Send API). Returns blockers and warnings without sending mail.

Public scan report

scanner v0.1.10 · 2026-10-12 · same rubric, same numbers if you re-run it

no findings
  • Code scan20 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 0 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How SendGrid Transactional compares

Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 75% of 914 Email servers
Tools
78
the typical Email server has 7
Tools that change things
45%
typical: 25%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 492 Email servers
Downloads a week
566
more than 86% of 231 Email servers with a package

What its tools let an agent do: 39 read · 7 create · 21 change · 6 delete · 5 send or post

Install SendGrid Transactional in Claude Code, Cursor or VS Code

Runs npx -y @neschadin/sendgrid-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add sendgrid-mcp -- npx -y @neschadin/sendgrid-mcp
Add to Cursor

What the publisher says

From the SendGrid Transactional repository's README, as published. We do not edit it. Read it on GitHub

SendGrid MCP Server

This server is for transactional send and delivery, not a map of the whole SendGrid API.

A thin SendGrid MCP treats POST /v3/mail/send as one call and spends the rest of its tools on contacts, lists, and campaigns. Those marketing APIs are out of scope here. The tools follow the checks SendGrid's own delivery troubleshooting expects:

  1. Before send. sendgridvalidatesendrequest checks the /v3/mail/send payload, that the dynamic template version is active, sender identity (domain authentication or a verified sender), link branding, recipient suppressions including the ASM group on the send, the DMARC warn list (GET /v3/verifiedsenders/domains), and that sendat is in the future and inside 72 hours. sendgridsendwithpreflight posts only when that report has no blockers. Sandbox mode accepts the payload and does not deliver.
  2. After accept. The x-message-id response header is not a msgid. Pass it as xMessageId; search compiles msgid LIKE '%', then sendgridgetmessageactivity reads the event chain (reason, bouncetype, asmgroupid, outboundip). Email Activity has no real offset. If Activity returns 403/404, or the region is eu and Activity is empty, use Email Logs (POST /v3/logs) with toemail equality. Logs rejects msgid, fromemail, and LIKE.
  3. When it did not arrive. sendgridchecksuppression and sendgridtriagedeliveryissue cover bounce, block, spam, invalid, global unsubscribe, and ASM groups. sendgriddeletesuppression lifts one entry. sendgridclassifysendgriderror and sendgridgetscopes explain a 403. Paused or canceled scheduled batches are listed; a batch that was only given send_at is not in that list until you pause or cancel it.
  4. The pipe around the send. Dynamic templates (including bulk rename and pruning inactive versions), Event Webhook create/update/test plus an optional local receiver, and the console settings that change delivery: domains, link branding, enforced TLS, mail and tracking settings, alerts, inbound parse.

Install: bunx --no-env-file x @neschadin/sendgrid-mcp.

Full catalog and runbooks: MCP_TOOLS.md.

This project is community-maintained and is not affiliated with, endorsed by, or sponsored by Twilio SendGrid.

Requirements

  • Bun ≥ 1.4.3
  • A SendGrid API key with scopes for the tools you call. Keys normally start with SG.; any other prefix only logs a warning
  • A verified sender address in SENDGRIDFROMEMAIL
  • An MCP client (Cursor, Claude Desktop, VS Code, etc.)

One process, one API key. Do not share a hosted instance across tenants.

Configuration

Required

SendGrid

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

SendGrid Transactional: common questions

Is SendGrid Transactional MCP server safe?
Mostly: it is graded B (83/100). Read the SendGrid Transactional safety report
How do I install SendGrid Transactional?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does SendGrid Transactional need an API key?
Yes. The registry entry asks for SENDGRID_API_KEY.
Is SendGrid Transactional maintained?
The last commit was 21 days ago (2026-10-12). The latest release is v3.0.3.
What can I use instead of SendGrid Transactional?
Servers from other publishers that do the same job: Sendgrid MCP server, MisarMail MCP Server and SendGrid MCP Server. Compare all SendGrid Transactional alternatives.
How does SendGrid Transactional compare with other Email MCP servers?
safety score 83/100 (higher than 75% of 914 Email servers); tools 78 (the typical Email server has 7); tools that change things 45% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to SendGrid Transactional

Same job from other publishers: the closest match first, then the best rated.

All SendGrid Transactional alternatives →
  • Sendgrid
    MCP server for SendGrid — global transactional + marketing email (Twilio-owned)
    B
  • MisarMail MCP Server
    Send transactional email, run campaigns, manage contacts and automations, audit deliverability.
    A
  • SendGrid MCP Server
    MCP server for SendGrid's v3 API: email marketing, transactional mail, templates, and analytics.
    B
  • Mailkite
    Send email, manage domains, DNS, webhooks, templates, and inbound routing on MailKite
    A
  • Postmark
    Send, track, and manage transactional and bulk email delivery
    B