Connect your AI Agents to SendGrid in minutes

Merge lets you securely connect your agents to SendGrid and thousands of tools instantly

Available tools

list_api_keys

List all API keys in your SendGrid account. Does not include the actual key values.

get_api_key

Get details of a specific API key by ID. Does not return the actual key value.

create_api_key

Create a new API key with specified scopes. IMPORTANT: The key value is only shown once on creation.

update_api_key

Update an API key's name or scopes.

delete_api_key

Delete an API key. This action is irreversible.

send_email

Send an email via SendGrid. Supports plain text, HTML, templates, attachments, and batch sending with personalizations.

send_simple_email

Send a simple email with just recipient, sender, subject, and text/HTML content. For more advanced options, use send_email.

send_template_email

Send an email using a SendGrid dynamic template with personalization data.

list_verified_senders

List all verified sender identities in your SendGrid account.

create_verified_sender

Create a new verified sender identity. A verification email will be sent to the address.

update_verified_sender

Update a verified sender's details.

delete_verified_sender

Delete a verified sender identity.

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's SendGrid  MCP server

FAQs on using Merge's SendGrid  MCP server

What is a SendGrid MCP server?

It’s an MCP server that exposes data and functionality from SendGrid via tools. Your agents can use these tools to get mailbox provider stats, delete a spam report, update a suppression group, and more.

Sendgrid doesn’t currently offer its own MCP server, so you’ll need to use one provided by a public repo or through a 3rd-party like Merge.

How can I use a SendGrid MCP server?

Here are some common use cases:

  • Transactional email orchestration: Trigger password resets, MFA codes, email verifications, and receipt emails directly from agent workflows
  • Lifecycle and nurture campaigns: Enroll users into drip sequences based on product events (e.g., signup) and update segments dynamically
  • Support and incident communications: Send proactive incident updates, maintenance notices, and ticket follow-ups, with consistent templates and status-aware messaging
  • Billing and collections: Automate dunning sequences, invoice reminders, failed payment notifications, and “payment received” confirmations with tailored copy by account tier
  • Product announcements and release notes: Create targeted announcements (by plan, region, feature flag, etc.) and track engagement to inform follow-up actions

What are some common tools for SendGrid’s MCP server?

Here are some common tools across data types:

Contacts

  • <code class="blog_inline-code">get_contact</code>
  • <code class="blog_inline-code">list_contacts</code>
  • <code class="blog_inline-code">delete_contacts</code>
  • <code class="blog_inline-code">search_contacts</code>

Senders

  • <code class="blog_inline-code">create_verified_sender</code>
  • <code class="blog_inline-code">update_verified_sender</code>
  • <code class="blog_inline-code">delete_verified_sender</code>
  • <code class="blog_inline-code">list_verified_senders</code>

Suppression groups

  • <code class="blog_inline-code">update_suppression_group</code>
  • <code class="blog_inline-code">get_suppression_group</code>
  • <code class="blog_inline-code">delete_suppression_group</code>
  • <code class="blog_inline-code">list_group_suppression</code>

What makes Merge Agent Handler’s SendGrid MCP server better than alternative SendGrid MCP servers?

In addition to providing 80+ tools out of the box, Merge Agent Handler SendGrid MCP server comes with platform-level capabilities:

  • Enterprise-grade security and DLP: All tool inputs and outputs are scanned through a security gateway with configurable data loss prevention rules, allowing sensitive data to be blocked, redacted, or masked before reaching third-party systems
  • Built-in authentication and credential management: Merge manages connector authentication flows, credential storage, and token handling so agents can securely call tools without custom auth logic
  • Real-time observability and audit trail: Every tool call is logged with a fully searchable activity log, enabling teams to audit, debug, and optimize agent behavior across all connectors, including SendGrid
  • Evaluation Suite before production deployment: Tools can be validated against expected outcomes in controlled scenarios before being enabled in live environments

Can I set custom security rules for SendGrid tool calls?

Yes, Merge Agent Handler lets you set a variety of custom rules. For example:

  • Block any send where the payload includes full payment instrument data (PAN, CVV, full bank account), and only allow “last 4” patterns
  • Block sends if the body contains common internal-only markers (e.g., internal_note:, “discount approval”, “margin”, “net revenue”) to prevent agents from pasting CRM notes into prospect emails
  • Block any bulk marketing template send unless an unsubscribe token and required footer/address tokens are present (to avoid sending non-compliant campaigns)
  • Mask or drop PII fields (phone, street address, internal IDs) from any SendGrid contact/search tool responses before returning them to the agent, so the agent can't reuse them elsewhere
  • Log every SendGrid <code class="blog_inline-code">send_email</code> tool call (including template ID, recipient domain, message category, and whether a rule blocked or redacted content), then trigger an alert when high-risk patterns occur, like a spike in blocked sends or repeated attempts to email secrets or PII

How can I start using Merge Agent Handler's SendGrid MCP server?

You can take the following steps:

1. Create an Agent Handler account (and pick the right environment). Sign up or log in to Agent Handler, then make sure you are in the environment you plan to test in (for example, US multi-tenant, or EU if needed).

2. Add the SendGrid connector. In the Agent Handler dashboard, go to Connectors and add SendGrid.

3. Create a Tool Pack that includes SendGrid. Go to Tool Packs and create a new Tool Pack for your workflow, then add the SendGrid connector and select the specific tools you want your agent to be able to use.

4. Create a Registered User. In Registered Users, create an identity that your agent will run as (this is what credentials get attached to).

5. Connect (authenticate) SendGrid for that Registered User. Link the Registered User to SendGrid credentials using the Link flow, so authenticated tool calls can execute.

6. Test in the Playground and verify logs. Run a couple SendGrid tool calls from the Tool Pack playground, then confirm you can see end-to-end execution details in Logs for debugging and auditability.

7. Use the Tool Pack from your agent runtime. From your agent, call “list tools” for the Tool Pack and then invoke SendGrid tools through Agent Handler, relying on policies, RBAC, and approvals as configured.

Explore other MCP servers built and managed by Merge

activecampaign
ActiveCampaign
airtable
Airtable
amadeus
Amadeus
amazon_s3
Amazon S3
anaplan
Anaplan
apollo
Apollo
articulate
Articulate Reach 360
asana
Asana
aviationstack
Aviationstack
bamboohr
BambooHR
basecamp
Basecamp
bitbucket
Bitbucket
box
Box
cms_coverage
CMS Coverage
calendly
Calendly
canva
Canva
clickup
ClickUp
clinicaltrials
ClinicalTrials.gov
cloudflare
Cloudflare
confluence
Confluence
contentful
Contentful
crustdata
Crustdata
databricks
Databricks
datadog
Datadog
docusign
DocuSign
doordash
DoorDash
dropbox
Dropbox
duffel
Duffel
dynamics365
Dynamics 365 Sales
exa
Exa
expensify
Expensify
factset
FactSet
figma
Figma
firecrawl
Firecrawl
foursquare
Foursquare
freshbooks
FreshBooks
freshdesk
Freshdesk
freshservice
Freshservice
front
Front
gamma
Gamma
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_bigquery
Google BigQuery
google_calendar
Google Calendar
google_docs
Google Docs
google_drive
Google Drive
google_maps
Google Maps
google_meet
Google Meet
google_sheets
Google Sheets
google_slides
Google Slides
greenhouse
Greenhouse
hibob
HiBob
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
klaviyo
Klaviyo
linear
Linear
linkedin
LinkedIn
make
Make
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
npi_registry
NPI Registry
notion
Notion
onedrive
OneDrive
onenote
OneNote
oracle_hcm
Oracle HCM
outlook
Outlook
pagerduty
PagerDuty
paypal
PayPal
pipedrive
Pipedrive
pubmed
PubMed
pylon
Pylon
quartr
Quartr
quickbooks_online
QuickBooks Online
ramp
Ramp
rootly
Rootly
sapsf
SAP SuccessFactors
sabre
Sabre
salesforce
Salesforce
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
snowflake
Snowflake
spotify
Spotify
square
Square
straker
Straker
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
tripadvisor
TripAdvisor
visualping
VisualPing
weather
Weather
wikipedia
Wikipedia
workday
Workday

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now