
List all API keys in your SendGrid account. Does not include the actual key values.
Get details of a specific API key by ID. Does not return the actual key value.
Create a new API key with specified scopes. IMPORTANT: The key value is only shown once on creation.
Update an API key's name or scopes.
Delete an API key. This action is irreversible.
Send an email via SendGrid. Supports plain text, HTML, templates, attachments, and batch sending with personalizations.
Send a simple email with just recipient, sender, subject, and text/HTML content. For more advanced options, use send_email.
Send an email using a SendGrid dynamic template with personalization data.
List all verified sender identities in your SendGrid account.
Create a new verified sender identity. A verification email will be sent to the address.
Update a verified sender's details.
Delete a verified sender identity.
Resend the verification email for a pending verified sender.
List all authenticated domains for email sending. Authenticated domains improve deliverability.
Get details of a specific authenticated domain including DNS records.
Add a new domain for authentication. Returns DNS records to configure with your DNS provider.
Validate that DNS records are properly configured for a domain.
Delete an authenticated domain from your SendGrid account.
Get global email statistics including sends, opens, clicks, bounces, and unsubscribes for a date range.
Get email statistics filtered by categories for a date range.
Get geographic email statistics showing opens and clicks by country.
Get email statistics by mailbox provider (Gmail, Outlook, Yahoo, etc.).
Get email click statistics by browser type.
Get email open statistics by device type (desktop, mobile, tablet, webmail).
List all bounced email addresses. Bounces occur when an email cannot be delivered to the recipient.
Get bounce information for a specific email address.
Delete a single bounce record by email address, allowing future sends to that address.
Delete multiple bounce records by email or delete all bounces.
List all blocked email addresses. Blocks occur when the recipient server rejects your email.
Get block information for a specific email address.
Delete a single block record by email address.
Delete multiple block records by email or delete all blocks.
List all spam reports. Spam reports are filed when recipients mark your email as spam.
Get spam report information for a specific email address.
Delete a single spam report by email address.
Delete multiple spam reports by email or delete all spam reports.
List all globally unsubscribed email addresses. These addresses will not receive any emails.
Add email addresses to the global unsubscribe list. These addresses will not receive any emails.
Remove an email address from the global unsubscribe list, allowing emails to be sent again.
List all suppression groups. Suppression groups allow recipients to unsubscribe from specific types of emails.
Get details of a specific suppression group by ID.
Create a new suppression group for managing email preferences.
Update a suppression group's name, description, or default status.
Delete a suppression group. Cannot delete groups with active suppressions.
List all email addresses suppressed in a specific group.
Add email addresses to a suppression group, preventing them from receiving that type of email.
Remove an email address from a suppression group.
List all transactional email templates in SendGrid.
Get a transactional template by ID with all its versions.
Create a new transactional email template.
Update a transactional template name.
Delete a transactional template and all its versions.
Create a new version of an existing template with HTML/text content.
Get a specific template version by ID.
Update a template version content, subject, or active status.
Delete a specific template version.
Activate a specific template version to be used when sending emails.
Validate SendGrid credentials. Verifies credentials during setup.

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}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.
Here are some common use cases:
Here are some common tools across data types:
Contacts
Senders
Suppression groups
In addition to providing 80+ tools out of the box, Merge Agent Handler SendGrid MCP server comes with platform-level capabilities:
Yes, Merge Agent Handler lets you set a variety of custom rules. For example:
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.
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now