{
  "name": "io.github.sendgrid-mcp/sendgrid-mcp",
  "description": "A community SendGrid MCP connects an AI agent to a SendGrid account. Sends email via the Mail Send API, queries Activity Feed for delivery and engagement events, inspects suppression lists, and reads sender authentication state. Scoped via SendGrid API keys with the smallest necessary permission set (Mail Send + Stats Read by default).",
  "status": "active",
  "version": "latest",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-06-02",
    "com.top-mcps/score": {
      "value": 56,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-02T13:16:41.661Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-02T13:16:41.501Z",
      "npmWeeklyDownloads": 100
    }
  },
  "repository": {
    "url": "https://github.com/sendgrid-mcp/sendgrid-mcp",
    "source": "github"
  },
  "author": {
    "name": "Community"
  },
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "sendgrid-mcp",
      "version": "latest",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "SENDGRID_API_KEY",
          "description": "SENDGRID_API_KEY — required credential for SendGrid.",
          "isRequired": true,
          "isSecret": true
        },
        {
          "name": "SENDGRID_FROM",
          "description": "SENDGRID_FROM — required credential for SendGrid.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "send_mail",
        "description": "Send a transactional email via the v3 Mail Send API.",
        "sideEffect": "write",
        "args": [
          {
            "name": "to",
            "type": "string",
            "required": true
          },
          {
            "name": "subject",
            "type": "string",
            "required": true
          },
          {
            "name": "html",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "query_activity",
        "description": "Search the Activity Feed by recipient, status, or time window.",
        "sideEffect": "read",
        "args": [
          {
            "name": "query",
            "type": "object",
            "required": true
          }
        ]
      },
      {
        "name": "list_suppressions",
        "description": "List bounces, blocks, and spam reports.",
        "sideEffect": "read",
        "args": [
          {
            "name": "type",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "verify_sender",
        "description": "Check the verification status of a sender or domain.",
        "sideEffect": "read",
        "args": [
          {
            "name": "sender",
            "type": "string",
            "required": true
          }
        ]
      }
    ],
    "security": {
      "scope": "read-write",
      "sandbox": "Authenticates with a SendGrid API key scoped to the smallest necessary permissions. Send + read-stats by default; suppressions only when explicitly granted.",
      "gotchas": [
        "Never use a Full Access key — agents only need Mail Send + Stats Read.",
        "SENDGRID_FROM must be a verified sender or domain; unverified senders fail with 403.",
        "Activity Feed has a 30-day retention window — older events return empty without warning."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/sendgrid",
    "markdown": "https://top-mcps.com/mcp/sendgrid.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}