Skip to content

SendGrid MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.11.1 · published by io.usefulapi

Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.

Deletes · 2
CompareRegistry entry

11 tools: 2 can delete or cancel things and 9 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Deletes or cancels 2Claude Code: deny
  • sendgrid_add_or_update_contactsUPSERTS marketing contacts (creates new ones, updates existing ones by email) and optionally adds them to lists.No findings

    Why it is in this group

    • The name "sendgrid_add_or_update_contacts" says "add": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Add or update marketing contacts
    • destructiveHint: true
  • sendgrid_send_mailSENDS A REAL EMAIL immediately via SendGrid.No findings

    Why it is in this group

    • The name "sendgrid_send_mail" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Send email
    • destructiveHint: true
Only reads 9Claude Code: allow
  • sendgrid_get_contact_countGet the total number of Marketing Campaigns contacts on your account.No findings

    Why it is in this group

    • The name "sendgrid_get_contact_count" says "get": a word for reading.
    Description, as the server wrote it
    Get the total number of Marketing Campaigns contacts on your account. Returns { contact_count, billable_count }. SendGrid: GET /v3/marketing/contacts/count.

    Annotations the server declares

    • title: Get contact count
    • readOnlyHint: true
  • sendgrid_get_statsGet global email statistics over a date range (delivered, opens, clicks, bounces, spam reports, etc.).No findings

    Why it is in this group

    • The name "sendgrid_get_stats" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Get email stats
    • readOnlyHint: true
  • sendgrid_get_templateGet a single transactional email template by id, including its versions (subject + content).No findings

    Why it is in this group

    • The name "sendgrid_get_template" says "get": a word for reading.
    Description, as the server wrote it
    Get a single transactional email template by id, including its versions (subject + content). SendGrid: GET /v3/templates/{template_id}.

    Annotations the server declares

    • title: Get email template
    • readOnlyHint: true
  • sendgrid_list_bouncesList bounced email addresses (the bounce suppression list).No findings

    Why it is in this group

    • The name "sendgrid_list_bounces" says "list": a word for reading.
    Description, as the server wrote it
    List bounced email addresses (the bounce suppression list). Returns an array of { created, email, reason, status }. SendGrid: GET /v3/suppression/bounces.

    Annotations the server declares

    • title: List bounces
    • readOnlyHint: true
  • sendgrid_list_global_unsubscribesList globally-unsubscribed email addresses (the global suppression list).No findings

    Why it is in this group

    • The name "sendgrid_list_global_unsubscribes" says "list": a word for reading.
    Description, as the server wrote it
    List globally-unsubscribed email addresses (the global suppression list). Returns an array of { created, email }. SendGrid: GET /v3/suppression/unsubscribes.

    Annotations the server declares

    • title: List global unsubscribes
    • readOnlyHint: true
  • sendgrid_list_marketing_listsList your Marketing Campaigns contact lists, each with its id, name, and contact_count.No findings

    Why it is in this group

    • The name "sendgrid_list_marketing_lists" says "list": a word for reading.
    Description, as the server wrote it
    List your Marketing Campaigns contact lists, each with its id, name, and contact_count. Returns { result: [...], _metadata }. SendGrid: GET /v3/marketing/lists.

    Annotations the server declares

    • title: List marketing lists
    • readOnlyHint: true
  • sendgrid_list_templatesList your transactional email templates (Dynamic and/or Legacy).No findings

    Why it is in this group

    • The name "sendgrid_list_templates" says "list": a word for reading.
    Description, as the server wrote it
    List your transactional email templates (Dynamic and/or Legacy). Returns { result: [...], _metadata } — use _metadata.next / page_token to paginate. SendGrid: GET /v3/templates.

    Annotations the server declares

    • title: List email templates
    • readOnlyHint: true
  • sendgrid_pingHealth check — verifies the API key works and returns the scopes (permissions) granted to it.No findings

    Why it is in this group

    • The name "sendgrid_ping" says "ping": a word for reading.
    Description, as the server wrote it
    Health check — verifies the API key works and returns the scopes (permissions) granted to it. SendGrid: GET /v3/scopes.

    Annotations the server declares

    • title: Ping (health check)
    • readOnlyHint: true
  • sendgrid_search_contacts_by_emailLook up marketing contacts by exact email address (a read-only lookup — mutates nothing).No findings

    Why it is in this group

    • The name "sendgrid_search_contacts_by_email" says "search": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Search contacts by email
    • readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.11.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__sendgrid__sendgrid_ping",
      "mcp__sendgrid__sendgrid_list_templates",
      "mcp__sendgrid__sendgrid_get_template",
      "mcp__sendgrid__sendgrid_list_marketing_lists",
      "mcp__sendgrid__sendgrid_get_contact_count",
      "mcp__sendgrid__sendgrid_search_contacts_by_email",
      "mcp__sendgrid__sendgrid_get_stats",
      "mcp__sendgrid__sendgrid_list_bounces",
      "mcp__sendgrid__sendgrid_list_global_unsubscribes"
    ],
    "ask": [],
    "deny": [
      "mcp__sendgrid__sendgrid_send_mail",
      "mcp__sendgrid__sendgrid_add_or_update_contacts"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as sendgrid. Review it before you use it.