Connect your AI Agents to SendGrid in minutes

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}
11Open 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}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 }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}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





























































































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

