SendGrid

SendGrid MCP Server for Cloudflare Workers

Available Tools

141 tools available in the SendGrid MCP server. Each tool can be called by AI assistants to perform specific actions.

sendgrid_list_alerts

List all configured alerts.

Returns: All alerts with their types and settings.

{
  "type": "object",
  "properties": {}
}

sendgrid_delete_authenticated_domain

Delete domain authentication.

Args:

id: Domain ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Domain ID"
    }
  }
}

sendgrid_list_branded_links

List all branded links.

Branded links replace sendgrid.net tracking links with your domain.

Returns: All branded links with their DNS records.

{
  "type": "object",
  "properties": {}
}

sendgrid_get_branded_link

Get details of a branded link.

Args:

id: Branded link ID

Returns: Link details including DNS records.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Link ID"
    }
  }
}

sendgrid_list_senders

List all sender identities.

Args:

format: Response format

Returns: All sender identities with verification status.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_send_single_send_now

Send a single send immediately.

Args:

id: Single send ID

Returns: The triggered single send.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    }
  }
}

sendgrid_delete_branded_link

Delete a branded link.

Args:

id: Branded link ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Link ID"
    }
  }
}

sendgrid_list_ips

List all IP addresses in your account.

Returns: All IP addresses with their pools and warmup status.

{
  "type": "object",
  "properties": {}
}

sendgrid_get_ip

Get details of a specific IP address.

Args:

ip: IP address

Returns: IP details including pools and warmup status.

{
  "type": "object",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address"
    }
  }
}

sendgrid_list_ip_pools

List all IP pools.

IP pools allow you to group IPs for different sending purposes.

Returns: All IP pools with their assigned IPs.

{
  "type": "object",
  "properties": {}
}

sendgrid_get_ip_pool

Get details of an IP pool.

Args:

name: Pool name

Returns: Pool details with assigned IPs.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pool name"
    }
  }
}

sendgrid_create_ip_pool

Create a new IP pool.

Args:

name: Pool name

Returns: The created pool.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pool name"
    }
  }
}

sendgrid_get_alert

Get details of a specific alert.

Args:

id: Alert ID

Returns: Alert details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Alert ID"
    }
  }
}

sendgrid_create_custom_field

Create a new custom field for contacts.

Args:

name: Field name (must be unique)
fieldType: Field type (Text, Number, or Date)

Returns: The created custom field.

{
  "type": "object",
  "required": [
    "name",
    "fieldType"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Field name"
    },
    "fieldType": {
      "enum": [
        "Text",
        "Number",
        "Date"
      ],
      "type": "string",
      "description": "Field type"
    }
  }
}

sendgrid_create_alert

Create a new alert.

Alert types:

stats_notification: Receive email stats at specified frequency
usage_limit: Alert when approaching credit limit

Args:

type: Alert type ('stats_notification' or 'usage_limit')
emailTo: Email address to send alerts to
frequency: For stats alerts: 'daily', 'weekly', or 'monthly'
percentage: For usage alerts: percentage threshold (e.g., 90)

Returns: The created alert.

{
  "type": "object",
  "required": [
    "type",
    "emailTo"
  ],
  "properties": {
    "type": {
      "enum": [
        "stats_notification",
        "usage_limit"
      ],
      "type": "string",
      "description": "Alert type"
    },
    "emailTo": {
      "type": "string",
      "description": "Alert recipient email"
    },
    "frequency": {
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "type": "string",
      "description": "Stats frequency"
    },
    "percentage": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Usage threshold %"
    }
  }
}

sendgrid_update_alert

Update an existing alert.

Args:

id: Alert ID
emailTo: New recipient email
frequency: New frequency for stats alerts
percentage: New threshold for usage alerts

Returns: The updated alert.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Alert ID"
    },
    "emailTo": {
      "type": "string",
      "description": "Recipient email"
    },
    "frequency": {
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ],
      "type": "string",
      "description": "Stats frequency"
    },
    "percentage": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Usage threshold"
    }
  }
}

sendgrid_delete_alert

Delete an alert.

Args:

id: Alert ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Alert ID"
    }
  }
}

sendgrid_list_api_keys

List all API keys for the account.

Note: The actual key values are not returned, only metadata.

Args:

format: Response format

Returns: List of API keys with their IDs, names, and scopes.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_get_api_key

Get metadata for a specific API key.

Args:

id: API key ID

Returns: API key metadata (not the actual key value).

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "API key ID"
    }
  }
}

sendgrid_create_api_key

Create a new API key.

IMPORTANT: The actual key value is only returned once during creation. Save it immediately!

Common scopes include:

mail.send
alerts.create, alerts.read, alerts.update, alerts.delete
marketing.automation.create, marketing.automation.read, marketing.automation.update, marketing.automation.delete
stats.read
suppressions.create, suppressions.read, suppressions.update, suppressions.delete
templates.create, templates.read, templates.update, templates.delete
user.profile.read, user.profile.update

Args:

name: Name for the API key
scopes: Array of permission scopes (optional, full access if not specified)

Returns: The created API key including the actual key value (SAVE THIS!).

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "API key name"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Permission scopes"
    }
  }
}

sendgrid_update_api_key

Update an API key's name and/or scopes.

Args:

id: API key ID
name: New name for the key
scopes: New scopes (if provided, replaces all existing scopes)

Returns: The updated API key.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "API key ID"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New scopes (replaces existing)"
    }
  }
}

sendgrid_delete_api_key

Delete an API key.

Warning: This action cannot be undone. Any applications using this key will lose access.

Args:

id: API key ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "API key ID"
    }
  }
}

sendgrid_list_contacts

List contacts from SendGrid Marketing.

Args:

pageToken: Token for pagination (optional)
format: Response format ('json' or 'markdown')

Returns: Paginated list of contacts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

sendgrid_get_contact

Get a single contact by ID.

Args:

id: The contact ID
format: Response format

Returns: The contact details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Contact ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_get_contact_by_email

Find a contact by email address.

Args:

email: The email address to search for

Returns: The contact if found, or null.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address"
    }
  }
}

sendgrid_add_contacts

Add or update contacts in SendGrid Marketing.

This is an upsert operation - existing contacts are updated, new contacts are created.

Args:

contacts: Array of contact objects with email (required) and optional fields
listIds: Optional array of list IDs to add contacts to

Returns: A job ID for tracking the import.

{
  "type": "object",
  "properties": {
    "listIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List IDs to add contacts to"
    }
  }
}

sendgrid_delete_contacts

Delete contacts from SendGrid Marketing.

Args:

ids: Array of contact IDs to delete
deleteAll: Set to true to delete ALL contacts (use with caution!)

Returns: A job ID for tracking the deletion.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Contact IDs to delete"
    },
    "deleteAll": {
      "type": "boolean",
      "description": "Delete all contacts"
    }
  }
}

sendgrid_search_contacts

Search contacts using SGQL (SendGrid Query Language).

Examples:

email LIKE '%@example.com%'
first_name = 'John' AND last_name = 'Doe'
created_at > '2024-01-01T00:00:00Z'

Args:

query: SGQL query string
format: Response format

Returns: Matching contacts.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "SGQL query string"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_get_contact_count

Get the total number of contacts in your account.

Returns: Contact count and billable count.

{
  "type": "object",
  "properties": {}
}

sendgrid_list_custom_fields

List all custom field definitions.

Returns: All custom fields with their IDs, names, and types.

{
  "type": "object",
  "properties": {}
}

sendgrid_update_custom_field

Update a custom field name.

Args:

id: Field ID
name: New field name

Returns: The updated custom field.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Field ID"
    },
    "name": {
      "type": "string",
      "description": "New field name"
    }
  }
}

sendgrid_delete_custom_field

Delete a custom field.

Warning: This will remove the field from all contacts.

Args:

id: Field ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Field ID"
    }
  }
}

sendgrid_list_designs

List designs from the design library.

Designs are reusable email templates that can be used with Single Sends.

Args:

pageSize: Number of results (default 50)
pageToken: Pagination token
format: Response format

Returns: Paginated list of designs.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    }
  }
}

sendgrid_get_design

Get a design by ID.

Args:

id: Design ID
format: Response format

Returns: Design details including HTML content.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Design ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_design

Create a new design in the design library.

Args:

name: Design name
subject: Email subject line
htmlContent: HTML email content
plainContent: Plain text content (optional)
generatePlainContent: Auto-generate plain text from HTML
editor: Editor type ('code' or 'design')
categories: Categories for organization

Returns: The created design.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Design name"
    },
    "editor": {
      "enum": [
        "code",
        "design"
      ],
      "type": "string",
      "description": "Editor type"
    },
    "subject": {
      "type": "string",
      "description": "Subject line"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Categories"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    },
    "plainContent": {
      "type": "string",
      "description": "Plain text content"
    },
    "generatePlainContent": {
      "type": "boolean",
      "default": true,
      "description": "Auto-generate plain text"
    }
  }
}

sendgrid_update_design

Update an existing design.

Args:

id: Design ID
name: New name
subject: New subject line
htmlContent: New HTML content
plainContent: New plain text content
categories: New categories

Returns: The updated design.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Design ID"
    },
    "name": {
      "type": "string",
      "description": "Name"
    },
    "subject": {
      "type": "string",
      "description": "Subject"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Categories"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    },
    "plainContent": {
      "type": "string",
      "description": "Plain text"
    }
  }
}

sendgrid_delete_design

Delete a design from the library.

Args:

id: Design ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Design ID"
    }
  }
}

sendgrid_duplicate_design

Duplicate an existing design.

Args:

id: Design ID to duplicate
name: Name for the new design (optional)

Returns: The duplicated design.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Design ID"
    },
    "name": {
      "type": "string",
      "description": "New design name"
    }
  }
}

sendgrid_list_authenticated_domains

List all authenticated domains.

Domain authentication (DKIM/SPF) improves deliverability and prevents spoofing.

Returns: All authenticated domains with their DNS records and validation status.

{
  "type": "object",
  "properties": {}
}

sendgrid_get_authenticated_domain

Get details of an authenticated domain.

Args:

id: Domain ID

Returns: Domain details including DNS records to configure.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Domain ID"
    }
  }
}

sendgrid_authenticate_domain

Start domain authentication process.

This will generate DNS records that you need to add to your domain.

Args:

domain: Domain to authenticate (e.g., example.com)
subdomain: Subdomain for DKIM (optional, defaults to em)
customSpf: Use custom SPF instead of SendGrid's
default: Set as the default sending domain
automaticSecurity: Enable automatic security (recommended)

Returns: The domain with DNS records to configure.

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain name"
    },
    "default": {
      "type": "boolean",
      "default": false,
      "description": "Set as default"
    },
    "customSpf": {
      "type": "boolean",
      "default": false,
      "description": "Custom SPF"
    },
    "subdomain": {
      "type": "string",
      "description": "Subdomain"
    },
    "automaticSecurity": {
      "type": "boolean",
      "default": true,
      "description": "Automatic security"
    }
  }
}

sendgrid_validate_domain

Validate DNS records for an authenticated domain.

Run this after adding DNS records to verify configuration.

Args:

id: Domain ID

Returns: Validation results for each DNS record.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Domain ID"
    }
  }
}

sendgrid_create_branded_link

Create a branded link.

Args:

domain: Domain for branded links (e.g., link.example.com)
subdomain: Subdomain (optional)
default: Set as the default branded link

Returns: The branded link with DNS records to configure.

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain"
    },
    "default": {
      "type": "boolean",
      "default": false,
      "description": "Set as default"
    },
    "subdomain": {
      "type": "string",
      "description": "Subdomain"
    }
  }
}

sendgrid_validate_branded_link

Validate DNS records for a branded link.

Args:

id: Branded link ID

Returns: Validation results.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Link ID"
    }
  }
}

sendgrid_update_ip_pool

Rename an IP pool.

Args:

name: Current pool name
newName: New pool name

Returns: The updated pool.

{
  "type": "object",
  "required": [
    "name",
    "newName"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Current name"
    },
    "newName": {
      "type": "string",
      "description": "New name"
    }
  }
}

sendgrid_delete_ip_pool

Delete an IP pool.

IPs in the pool will not be deleted, just removed from the pool.

Args:

name: Pool name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Pool name"
    }
  }
}

sendgrid_add_ip_to_pool

Add an IP address to a pool.

Args:

poolName: Pool name
ip: IP address to add

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "poolName",
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address"
    },
    "poolName": {
      "type": "string",
      "description": "Pool name"
    }
  }
}

sendgrid_remove_ip_from_pool

Remove an IP address from a pool.

Args:

poolName: Pool name
ip: IP address to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "poolName",
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address"
    },
    "poolName": {
      "type": "string",
      "description": "Pool name"
    }
  }
}

sendgrid_list_ip_warmup

List all IPs currently in warmup.

Returns: IPs in warmup with their status.

{
  "type": "object",
  "properties": {}
}

sendgrid_start_ip_warmup

Start the warmup process for an IP.

Warmup gradually increases sending volume to build reputation.

Args:

ip: IP address to warm up

Returns: The IP with warmup status.

{
  "type": "object",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address"
    }
  }
}

sendgrid_stop_ip_warmup

Stop the warmup process for an IP.

Args:

ip: IP address

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "IP address"
    }
  }
}

sendgrid_list_contact_lists

List all contact lists in SendGrid Marketing.

Args:

format: Response format ('json' or 'markdown')

Returns: All contact lists with their IDs, names, and contact counts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_get_contact_list

Get details of a specific contact list.

Args:

id: The list ID
format: Response format

Returns: List details including contact count.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "List ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_contact_list

Create a new contact list.

Args:

name: Name for the list (required)

Returns: The created list.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "List name"
    }
  }
}

sendgrid_update_contact_list

Update a contact list name.

Args:

id: List ID to update
name: New name for the list

Returns: The updated list.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "List ID"
    },
    "name": {
      "type": "string",
      "description": "New list name"
    }
  }
}

sendgrid_delete_contact_list

Delete a contact list.

Args:

id: List ID to delete
deleteContacts: Also delete contacts that are only in this list

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "List ID"
    },
    "deleteContacts": {
      "type": "boolean",
      "default": false,
      "description": "Also delete contacts"
    }
  }
}

sendgrid_get_list_contact_count

Get the number of contacts in a specific list.

Args:

id: List ID

Returns: Contact count and billable count for the list.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "List ID"
    }
  }
}

sendgrid_add_contacts_to_list

Add existing contacts to a list.

Args:

listId: The list ID
contactIds: Array of contact IDs to add

Returns: Job ID for tracking.

{
  "type": "object",
  "required": [
    "listId",
    "contactIds"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "contactIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Contact IDs to add"
    }
  }
}

sendgrid_remove_contacts_from_list

Remove contacts from a list (does not delete the contacts).

Args:

listId: The list ID
contactIds: Array of contact IDs to remove

Returns: Job ID for tracking.

{
  "type": "object",
  "required": [
    "listId",
    "contactIds"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "contactIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Contact IDs to remove"
    }
  }
}

sendgrid_get_sender

Get a sender identity by ID.

Args:

id: Sender ID
format: Response format

Returns: Sender identity details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Sender ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_cancel_single_send_schedule

Cancel a scheduled single send.

Returns the single send to draft status.

Args:

id: Single send ID

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    }
  }
}

sendgrid_send_email

Send an email using SendGrid.

Args:

to: Array of recipient email addresses (required)
from: Sender email address (required)
fromName: Sender name (optional)
subject: Email subject line (required, unless using a template with subject)
text: Plain text email body (optional)
html: HTML email body (optional)
templateId: SendGrid template ID for dynamic templates (optional)
dynamicTemplateData: Data for template substitution (optional)
cc: Array of CC email addresses (optional)
bcc: Array of BCC email addresses (optional)
replyTo: Reply-to email address (optional)
categories: Array of categories for tracking (optional)
sendAt: Unix timestamp for scheduled sending (optional)
attachments: Array of attachments with base64 content (optional)

Returns: Confirmation of email being accepted for delivery.

{
  "type": "object",
  "required": [
    "to",
    "from"
  ],
  "properties": {
    "cc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "CC email addresses"
    },
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recipient email addresses"
    },
    "bcc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "BCC email addresses"
    },
    "from": {
      "type": "string",
      "description": "Sender email address"
    },
    "html": {
      "type": "string",
      "description": "HTML email body"
    },
    "text": {
      "type": "string",
      "description": "Plain text email body"
    },
    "sendAt": {
      "type": "integer",
      "description": "Unix timestamp for scheduled send"
    },
    "replyTo": {
      "type": "string",
      "description": "Reply-to email address"
    },
    "subject": {
      "type": "string",
      "description": "Email subject line"
    },
    "fromName": {
      "type": "string",
      "description": "Sender name"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tracking categories"
    },
    "templateId": {
      "type": "string",
      "description": "SendGrid template ID"
    },
    "dynamicTemplateData": {
      "type": "object",
      "description": "Template substitution data"
    }
  }
}

sendgrid_send_batch_email

Send personalized emails to multiple recipients in a single API call.

Each recipient can have their own substitution data for dynamic content.

Args:

from: Sender email address (required)
fromName: Sender name (optional)
subject: Default email subject (can be overridden per recipient)
text: Plain text email body
html: HTML email body
templateId: SendGrid template ID
personalizations: Array of recipient customizations with to, cc, bcc, subject, dynamicTemplateData
categories: Tracking categories
sendAt: Unix timestamp for scheduled send

Returns: Confirmation of batch email being accepted.

{
  "type": "object",
  "required": [
    "from"
  ],
  "properties": {
    "from": {
      "type": "string",
      "description": "Sender email address"
    },
    "html": {
      "type": "string",
      "description": "HTML body"
    },
    "text": {
      "type": "string",
      "description": "Plain text body"
    },
    "sendAt": {
      "type": "integer"
    },
    "subject": {
      "type": "string",
      "description": "Default subject line"
    },
    "fromName": {
      "type": "string",
      "description": "Sender name"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

sendgrid_create_batch_id

Create a batch ID for scheduling or canceling emails.

Use this batch ID when sending emails to be able to cancel or pause them later.

Returns: A unique batch ID to use with sendgrid_send_email's batchId parameter.

{
  "type": "object",
  "properties": {}
}

sendgrid_validate_batch_id

Validate that a batch ID exists and is valid.

Args:

batchId: The batch ID to validate

Returns: Whether the batch ID is valid.

{
  "type": "object",
  "required": [
    "batchId"
  ],
  "properties": {
    "batchId": {
      "type": "string",
      "description": "Batch ID to validate"
    }
  }
}

sendgrid_list_scheduled_sends

List all scheduled sends that have been paused or cancelled.

Returns: List of scheduled sends with their batch IDs and statuses.

{
  "type": "object",
  "properties": {}
}

sendgrid_cancel_scheduled_send

Cancel a scheduled send by batch ID.

Emails that have already been sent cannot be cancelled.

Args:

batchId: The batch ID of the scheduled send

Returns: Confirmation of cancellation.

{
  "type": "object",
  "required": [
    "batchId"
  ],
  "properties": {
    "batchId": {
      "type": "string",
      "description": "Batch ID to cancel"
    }
  }
}

sendgrid_pause_scheduled_send

Pause a scheduled send by batch ID.

Args:

batchId: The batch ID of the scheduled send

Returns: Confirmation of pause.

{
  "type": "object",
  "required": [
    "batchId"
  ],
  "properties": {
    "batchId": {
      "type": "string",
      "description": "Batch ID to pause"
    }
  }
}

sendgrid_list_segments

List all segments in SendGrid Marketing.

Args:

parentListIds: Filter by parent list IDs (optional)
format: Response format

Returns: All segments with their IDs, names, and contact counts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "parentListIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by parent list IDs"
    }
  }
}

sendgrid_get_segment

Get details of a specific segment.

Args:

id: Segment ID
format: Response format

Returns: Segment details including query and contact count.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Segment ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_segment

Create a new segment using SGQL query.

Example queries:

email LIKE '%@example.com'
first_name = 'John'
created_at > '2024-01-01T00:00:00Z'
(first_name = 'John' OR first_name = 'Jane') AND last_name = 'Doe'

Args:

name: Segment name
queryDsl: SGQL query defining the segment
parentListIds: Optional list IDs to scope the segment

Returns: The created segment.

{
  "type": "object",
  "required": [
    "name",
    "queryDsl"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Segment name"
    },
    "queryDsl": {
      "type": "string",
      "description": "SGQL query"
    },
    "parentListIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Parent list IDs"
    }
  }
}

sendgrid_update_segment

Update an existing segment.

Args:

id: Segment ID
name: New name (optional)
queryDsl: New SGQL query (optional)

Returns: The updated segment.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Segment ID"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "queryDsl": {
      "type": "string",
      "description": "New SGQL query"
    }
  }
}

sendgrid_delete_segment

Delete a segment.

Args:

id: Segment ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Segment ID"
    }
  }
}

sendgrid_create_sender

Create a new sender identity.

A verification email will be sent to the from address.

Args:

nickname: Display name for the sender
fromEmail: From email address
fromName: From display name
replyToEmail: Reply-to email address (optional)
address: Physical address (required for CAN-SPAM compliance)
address2: Address line 2
city: City
state: State/Province
zip: ZIP/Postal code
country: Country

Returns: The created sender identity.

{
  "type": "object",
  "required": [
    "nickname",
    "fromEmail",
    "address",
    "city",
    "country"
  ],
  "properties": {
    "zip": {
      "type": "string",
      "description": "ZIP/Postal code"
    },
    "city": {
      "type": "string",
      "description": "City"
    },
    "state": {
      "type": "string",
      "description": "State/Province"
    },
    "address": {
      "type": "string",
      "description": "Street address"
    },
    "country": {
      "type": "string",
      "description": "Country"
    },
    "address2": {
      "type": "string",
      "description": "Address line 2"
    },
    "fromName": {
      "type": "string",
      "description": "From display name"
    },
    "nickname": {
      "type": "string",
      "description": "Sender nickname"
    },
    "fromEmail": {
      "type": "string",
      "description": "From email address"
    },
    "replyToEmail": {
      "type": "string",
      "description": "Reply-to email"
    }
  }
}

sendgrid_list_spam_reports

List email addresses that have reported emails as spam.

Args:

startTime: Unix timestamp for start time
endTime: Unix timestamp for end time
limit: Number of results
offset: Pagination offset
format: Response format

Returns: List of spam reports.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer"
    },
    "startTime": {
      "type": "integer"
    }
  }
}

sendgrid_update_sender

Update a sender identity.

Args:

id: Sender ID
nickname: New nickname
fromName: New from display name
replyToEmail: New reply-to email
address: New address
city: New city
country: New country

Returns: The updated sender identity.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Sender ID"
    },
    "city": {
      "type": "string",
      "description": "City"
    },
    "address": {
      "type": "string",
      "description": "Address"
    },
    "country": {
      "type": "string",
      "description": "Country"
    },
    "fromName": {
      "type": "string",
      "description": "From name"
    },
    "nickname": {
      "type": "string",
      "description": "Nickname"
    },
    "replyToEmail": {
      "type": "string",
      "description": "Reply-to email"
    }
  }
}

sendgrid_delete_sender

Delete a sender identity.

Args:

id: Sender ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Sender ID"
    }
  }
}

sendgrid_resend_sender_verification

Resend the verification email for a sender identity.

Args:

id: Sender ID

Returns: Confirmation that verification email was sent.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Sender ID"
    }
  }
}

sendgrid_list_single_sends

List marketing single sends (campaigns).

Args:

status: Filter by status ('draft', 'scheduled', 'triggered')
format: Response format

Returns: List of single sends.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "status": {
      "enum": [
        "draft",
        "scheduled",
        "triggered"
      ],
      "type": "string",
      "description": "Filter by status"
    }
  }
}

sendgrid_get_single_send

Get a single send by ID.

Args:

id: Single send ID
format: Response format

Returns: Single send details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_single_send

Create a new single send (marketing campaign).

Args:

name: Campaign name
subject: Email subject
htmlContent: HTML email body
plainContent: Plain text body (optional, can be auto-generated)
senderId: Sender identity ID
listIds: List IDs to send to
segmentIds: Segment IDs to send to
sendToAll: Send to all contacts
categories: Tracking categories
suppressionGroupId: Unsubscribe group ID

Returns: The created single send.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Campaign name"
    },
    "listIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List IDs"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "senderId": {
      "type": "integer",
      "description": "Sender identity ID"
    },
    "sendToAll": {
      "type": "boolean",
      "description": "Send to all contacts"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Categories"
    },
    "segmentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Segment IDs"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    },
    "plainContent": {
      "type": "string",
      "description": "Plain text content"
    },
    "suppressionGroupId": {
      "type": "integer",
      "description": "Suppression group ID"
    }
  }
}

sendgrid_update_single_send

Update a single send.

Args:

id: Single send ID
name: New name
subject: New subject
htmlContent: New HTML content
listIds: New list IDs
segmentIds: New segment IDs

Returns: The updated single send.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    },
    "name": {
      "type": "string",
      "description": "Campaign name"
    },
    "listIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List IDs"
    },
    "subject": {
      "type": "string",
      "description": "Subject"
    },
    "segmentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Segment IDs"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    }
  }
}

sendgrid_delete_single_send

Delete a single send.

Args:

id: Single send ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    }
  }
}

sendgrid_schedule_single_send

Schedule a single send for future delivery.

Args:

id: Single send ID
sendAt: ISO 8601 datetime string

Returns: The scheduled single send.

{
  "type": "object",
  "required": [
    "id",
    "sendAt"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Single send ID"
    },
    "sendAt": {
      "type": "string",
      "description": "ISO 8601 datetime (e.g., 2024-12-25T10:00:00Z)"
    }
  }
}

sendgrid_get_stats

Get global email statistics.

Args:

startDate: Start date (YYYY-MM-DD format, required)
endDate: End date (YYYY-MM-DD format, optional)
aggregatedBy: Aggregation period ('day', 'week', or 'month')
format: Response format

Returns: Email statistics including requests, delivered, opens, clicks, bounces, etc.

{
  "type": "object",
  "required": [
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date (YYYY-MM-DD)"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "aggregatedBy": {
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string",
      "description": "Aggregation period"
    }
  }
}

sendgrid_get_category_stats

Get email statistics by category.

Categories are tags you assign when sending emails for tracking purposes.

Args:

categories: Array of category names to get stats for
startDate: Start date (YYYY-MM-DD)
endDate: End date (YYYY-MM-DD, optional)
aggregatedBy: Aggregation period
format: Response format

Returns: Statistics broken down by category.

{
  "type": "object",
  "required": [
    "categories",
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Category names"
    },
    "aggregatedBy": {
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string"
    }
  }
}

sendgrid_delete_spam_reports

Delete spam report records.

Warning: Sending to addresses that reported spam may harm your sender reputation.

Args:

emails: Array of email addresses to remove
deleteAll: Delete ALL spam reports

Returns: Confirmation of deletion.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "deleteAll": {
      "type": "boolean"
    }
  }
}

sendgrid_get_mailbox_provider_stats

Get statistics by mailbox provider (Gmail, Yahoo, Outlook, etc.).

Args:

startDate: Start date (YYYY-MM-DD)
endDate: End date (optional)
mailboxProviders: Filter to specific providers (optional)
format: Response format

Returns: Statistics broken down by mailbox provider.

{
  "type": "object",
  "required": [
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    },
    "mailboxProviders": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific providers to include"
    }
  }
}

sendgrid_get_browser_stats

Get statistics by browser type for link clicks.

Args:

startDate: Start date (YYYY-MM-DD)
endDate: End date (optional)
format: Response format

Returns: Click statistics broken down by browser.

{
  "type": "object",
  "required": [
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

sendgrid_get_device_stats

Get statistics by device type (desktop, phone, tablet, etc.).

Args:

startDate: Start date (YYYY-MM-DD)
endDate: End date (optional)
format: Response format

Returns: Statistics broken down by device type.

{
  "type": "object",
  "required": [
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

sendgrid_get_geography_stats

Get statistics by geographic location.

Args:

startDate: Start date (YYYY-MM-DD)
endDate: End date (optional)
country: Filter to a specific country (optional)
format: Response format

Returns: Statistics broken down by geography.

{
  "type": "object",
  "required": [
    "startDate"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "Country code to filter"
    },
    "endDate": {
      "type": "string",
      "description": "End date"
    },
    "startDate": {
      "type": "string",
      "description": "Start date (YYYY-MM-DD)"
    }
  }
}

sendgrid_list_subusers

List all subusers.

Subusers allow you to segment your email sending and statistics.

Args:

limit: Number of results (default 500)
offset: Pagination offset

Returns: List of subusers.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  }
}

sendgrid_get_subuser

Get details of a subuser.

Args:

username: Subuser username

Returns: Subuser details.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Subuser username"
    }
  }
}

sendgrid_create_subuser

Create a new subuser.

Args:

username: Unique username
email: Email address for the subuser
password: Password (min 8 characters)
ips: Array of IP addresses to assign

Returns: The created subuser.

{
  "type": "object",
  "required": [
    "username",
    "email",
    "password",
    "ips"
  ],
  "properties": {
    "ips": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "IP addresses"
    },
    "email": {
      "type": "string",
      "description": "Email"
    },
    "password": {
      "type": "string",
      "description": "Password"
    },
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_delete_subuser

Delete a subuser.

Warning: This cannot be undone.

Args:

username: Subuser username

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_enable_subuser

Enable a disabled subuser.

Args:

username: Subuser username

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_disable_subuser

Disable a subuser (prevents sending).

Args:

username: Subuser username

Returns: Confirmation.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_list_bounces

List email addresses that have bounced.

Args:

startTime: Unix timestamp for start time filter
endTime: Unix timestamp for end time filter
limit: Number of results (default 500)
offset: Offset for pagination
format: Response format

Returns: List of bounced email addresses with reasons.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer",
      "description": "End time (Unix timestamp)"
    },
    "startTime": {
      "type": "integer",
      "description": "Start time (Unix timestamp)"
    }
  }
}

sendgrid_get_bounce

Get bounce information for a specific email address.

Args:

email: Email address to look up

Returns: Bounce details if the email has bounced.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address"
    }
  }
}

sendgrid_delete_bounces

Delete bounce records to allow re-sending to those addresses.

Args:

emails: Array of email addresses to remove from bounces
deleteAll: Delete ALL bounce records (use with caution!)

Returns: Confirmation of deletion.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails to delete"
    },
    "deleteAll": {
      "type": "boolean",
      "description": "Delete all bounces"
    }
  }
}

sendgrid_list_blocks

List email addresses that have been blocked.

Blocks occur when the receiving server rejects the email (different from bounces).

Args:

startTime: Unix timestamp for start time
endTime: Unix timestamp for end time
limit: Number of results
offset: Pagination offset
format: Response format

Returns: List of blocked email addresses.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer"
    },
    "startTime": {
      "type": "integer"
    }
  }
}

sendgrid_delete_blocks

Delete block records.

Args:

emails: Array of email addresses to remove from blocks
deleteAll: Delete ALL block records

Returns: Confirmation of deletion.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "deleteAll": {
      "type": "boolean"
    }
  }
}

sendgrid_list_invalid_emails

List email addresses that are invalid.

Args:

startTime: Unix timestamp for start time
endTime: Unix timestamp for end time
limit: Number of results
offset: Pagination offset
format: Response format

Returns: List of invalid email addresses.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer"
    },
    "startTime": {
      "type": "integer"
    }
  }
}

sendgrid_delete_invalid_emails

Delete invalid email records.

Args:

emails: Array of email addresses to remove
deleteAll: Delete ALL invalid emails

Returns: Confirmation of deletion.

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "deleteAll": {
      "type": "boolean"
    }
  }
}

sendgrid_list_global_unsubscribes

List email addresses that have globally unsubscribed.

These addresses will not receive any emails until removed.

Args:

startTime: Unix timestamp for start time
endTime: Unix timestamp for end time
limit: Number of results
offset: Pagination offset
format: Response format

Returns: List of globally unsubscribed addresses.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer"
    },
    "startTime": {
      "type": "integer"
    }
  }
}

sendgrid_add_global_unsubscribe

Add email addresses to the global unsubscribe list.

Args:

emails: Array of email addresses to add

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses to add"
    }
  }
}

sendgrid_delete_global_unsubscribe

Remove an email address from the global unsubscribe list.

Args:

email: Email address to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to remove"
    }
  }
}

sendgrid_list_teammates

List all teammates on the account.

Teammates are users who can access the SendGrid account with specific permissions.

Args:

limit: Number of results
offset: Pagination offset

Returns: List of teammates.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 500,
      "maximum": 500,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  }
}

sendgrid_get_teammate

Get details of a teammate.

Args:

username: Teammate username

Returns: Teammate details including permissions.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Teammate username"
    }
  }
}

sendgrid_invite_teammate

Invite a new teammate to the account.

Common scopes include:

mail.send
stats.read
suppressions.read, suppressions.update, suppressions.delete
templates.read, templates.create, templates.update, templates.delete
marketing.read, marketing.update
user.profile.read

Args:

email: Email address to invite
scopes: Array of permission scopes
isAdmin: Grant admin access

Returns: Invitation details.

{
  "type": "object",
  "required": [
    "email",
    "scopes"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email to invite"
    },
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Permission scopes"
    },
    "isAdmin": {
      "type": "boolean",
      "default": false,
      "description": "Admin access"
    }
  }
}

sendgrid_update_teammate_permissions

Update a teammate's permissions.

Args:

username: Teammate username
scopes: New permission scopes
isAdmin: Grant or revoke admin access

Returns: The updated teammate.

{
  "type": "object",
  "required": [
    "username",
    "scopes"
  ],
  "properties": {
    "scopes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New scopes"
    },
    "isAdmin": {
      "type": "boolean",
      "description": "Admin status"
    },
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_delete_teammate

Remove a teammate from the account.

Args:

username: Teammate username

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Username"
    }
  }
}

sendgrid_list_templates

List transactional templates.

Args:

generations: Filter by template type ('legacy' or 'dynamic')
pageSize: Number of templates per page (default 50)
pageToken: Pagination token
format: Response format

Returns: Paginated list of templates.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageSize": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Page size"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "generations": {
      "enum": [
        "legacy",
        "dynamic"
      ],
      "type": "string",
      "description": "Template generation type"
    }
  }
}

sendgrid_get_template

Get a template by ID with all versions.

Args:

id: Template ID
format: Response format

Returns: Template details including all versions.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_template

Create a new transactional template.

Args:

name: Template name
generation: Template type ('legacy' or 'dynamic', default 'dynamic')

Returns: The created template (without versions).

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name"
    },
    "generation": {
      "enum": [
        "legacy",
        "dynamic"
      ],
      "type": "string",
      "default": "dynamic",
      "description": "Template type"
    }
  }
}

sendgrid_update_template

Update a template name.

Args:

id: Template ID
name: New template name

Returns: The updated template.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    },
    "name": {
      "type": "string",
      "description": "New name"
    }
  }
}

sendgrid_delete_template

Delete a template and all its versions.

Args:

id: Template ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

sendgrid_duplicate_template

Duplicate an existing template.

Args:

id: Template ID to duplicate
name: Name for the new template (optional)

Returns: The duplicated template.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template ID"
    },
    "name": {
      "type": "string",
      "description": "New template name"
    }
  }
}

sendgrid_create_template_version

Create a new version for a template.

For dynamic templates, use Handlebars syntax for substitution:

{{variable}} for plain text
{{{variable}}} for HTML content
{{#if condition}}...{{/if}} for conditionals
{{#each array}}...{{/each}} for loops

Args:

templateId: Parent template ID
name: Version name
subject: Email subject line (can include substitutions)
htmlContent: HTML email body
plainContent: Plain text email body
active: Set as active version (default true)
editor: Editor type ('code' or 'design')
generatePlainContent: Auto-generate plain text from HTML

Returns: The created version.

{
  "type": "object",
  "required": [
    "templateId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Version name"
    },
    "active": {
      "type": "boolean",
      "default": true,
      "description": "Set as active"
    },
    "editor": {
      "enum": [
        "code",
        "design"
      ],
      "type": "string",
      "description": "Editor type"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    },
    "plainContent": {
      "type": "string",
      "description": "Plain text content"
    },
    "generatePlainContent": {
      "type": "boolean",
      "description": "Auto-generate plain text"
    }
  }
}

sendgrid_get_template_version

Get a specific template version.

Args:

templateId: Template ID
versionId: Version ID

Returns: The template version with content.

{
  "type": "object",
  "required": [
    "templateId",
    "versionId"
  ],
  "properties": {
    "versionId": {
      "type": "string",
      "description": "Version ID"
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

sendgrid_update_template_version

Update a template version.

Args:

templateId: Template ID
versionId: Version ID
name: New version name
subject: New subject line
htmlContent: New HTML content
plainContent: New plain text content
active: Set as active version

Returns: The updated version.

{
  "type": "object",
  "required": [
    "templateId",
    "versionId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Version name"
    },
    "active": {
      "type": "boolean",
      "description": "Active status"
    },
    "subject": {
      "type": "string",
      "description": "Subject line"
    },
    "versionId": {
      "type": "string",
      "description": "Version ID"
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    },
    "plainContent": {
      "type": "string",
      "description": "Plain text content"
    }
  }
}

sendgrid_delete_template_version

Delete a template version.

Args:

templateId: Template ID
versionId: Version ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "templateId",
    "versionId"
  ],
  "properties": {
    "versionId": {
      "type": "string",
      "description": "Version ID"
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

sendgrid_activate_template_version

Activate a template version.

The active version is used when sending emails with the template.

Args:

templateId: Template ID
versionId: Version ID to activate

Returns: The activated version.

{
  "type": "object",
  "required": [
    "templateId",
    "versionId"
  ],
  "properties": {
    "versionId": {
      "type": "string",
      "description": "Version ID"
    },
    "templateId": {
      "type": "string",
      "description": "Template ID"
    }
  }
}

sendgrid_list_unsubscribe_groups

List all unsubscribe groups (suppression groups).

Unsubscribe groups allow recipients to opt out of specific types of emails.

Args:

format: Response format

Returns: All unsubscribe groups.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_get_unsubscribe_group

Get an unsubscribe group by ID.

Args:

id: Group ID
format: Response format

Returns: Group details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

sendgrid_create_unsubscribe_group

Create a new unsubscribe group.

Args:

name: Group name (shown to recipients)
description: Description (shown to recipients)
isDefault: Set as the default group

Returns: The created group.

{
  "type": "object",
  "required": [
    "name",
    "description"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Group name"
    },
    "isDefault": {
      "type": "boolean",
      "default": false,
      "description": "Set as default"
    },
    "description": {
      "type": "string",
      "description": "Group description"
    }
  }
}

sendgrid_update_unsubscribe_group

Update an unsubscribe group.

Args:

id: Group ID
name: New name
description: New description

Returns: The updated group.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    },
    "name": {
      "type": "string",
      "description": "New name"
    },
    "description": {
      "type": "string",
      "description": "New description"
    }
  }
}

sendgrid_delete_unsubscribe_group

Delete an unsubscribe group.

Args:

id: Group ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

sendgrid_list_group_suppressions

List email addresses that have unsubscribed from a specific group.

Args:

groupId: Unsubscribe group ID

Returns: List of email addresses.

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

sendgrid_add_group_suppressions

Add email addresses to an unsubscribe group.

Args:

groupId: Unsubscribe group ID
emails: Array of email addresses to add

Returns: Confirmation of addition.

{
  "type": "object",
  "required": [
    "groupId",
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Email addresses"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

sendgrid_delete_group_suppression

Remove an email from an unsubscribe group.

Args:

groupId: Unsubscribe group ID
email: Email address to remove

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "groupId",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address"
    },
    "groupId": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

sendgrid_search_group_suppressions

Search for all groups an email is suppressed from.

Args:

email: Email address to search

Returns: List of groups the email is suppressed from.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address"
    }
  }
}

sendgrid_validate_email

Validate an email address.

Returns detailed information about the email's validity including:

Verdict (Valid, Risky, Invalid)
Score (0-1)
Domain validity
Syntax checks
Disposable address detection
Known bounce history

Note: This feature requires SendGrid Email Validation to be enabled.

Args:

email: Email address to validate
source: Source identifier for tracking (optional)

Returns: Detailed validation results.

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email to validate"
    },
    "source": {
      "type": "string",
      "description": "Source identifier"
    }
  }
}

sendgrid_get_event_webhook

Get the current event webhook configuration.

Event webhooks send real-time notifications about email events (delivered, opened, clicked, etc.).

Returns: Current webhook configuration including URL and enabled events.

{
  "type": "object",
  "properties": {}
}

sendgrid_update_event_webhook

Update the event webhook configuration.

Args:

enabled: Enable or disable the webhook
url: Webhook URL to receive events
delivered: Receive delivered events
open: Receive open events
click: Receive click events
bounce: Receive bounce events
deferred: Receive deferred events
dropped: Receive dropped events
spamReport: Receive spam report events
unsubscribe: Receive unsubscribe events
groupUnsubscribe: Receive group unsubscribe events
groupResubscribe: Receive group resubscribe events
processed: Receive processed events

Returns: The updated webhook configuration.

{
  "type": "object",
  "required": [
    "enabled",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "open": {
      "type": "boolean",
      "description": "Open events"
    },
    "click": {
      "type": "boolean",
      "description": "Click events"
    },
    "bounce": {
      "type": "boolean",
      "description": "Bounce events"
    },
    "dropped": {
      "type": "boolean",
      "description": "Dropped events"
    },
    "enabled": {
      "type": "boolean",
      "description": "Enable webhook"
    },
    "deferred": {
      "type": "boolean",
      "description": "Deferred events"
    },
    "delivered": {
      "type": "boolean",
      "description": "Delivered events"
    },
    "processed": {
      "type": "boolean",
      "description": "Processed events"
    },
    "spamReport": {
      "type": "boolean",
      "description": "Spam report events"
    },
    "unsubscribe": {
      "type": "boolean",
      "description": "Unsubscribe events"
    },
    "groupResubscribe": {
      "type": "boolean",
      "description": "Group resubscribe events"
    },
    "groupUnsubscribe": {
      "type": "boolean",
      "description": "Group unsubscribe events"
    }
  }
}

sendgrid_test_event_webhook

Send a test event to the webhook URL.

Args:

url: Webhook URL to test

Returns: Confirmation that test was sent.

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL to test"
    }
  }
}

sendgrid_list_inbound_parse_webhooks

List all inbound parse webhook configurations.

Inbound Parse allows you to receive emails and process them via webhook.

Returns: All inbound parse configurations.

{
  "type": "object",
  "properties": {}
}

sendgrid_get_inbound_parse_webhook

Get an inbound parse webhook by hostname.

Args:

hostname: The hostname/domain configured for inbound parse

Returns: Webhook configuration.

{
  "type": "object",
  "required": [
    "hostname"
  ],
  "properties": {
    "hostname": {
      "type": "string",
      "description": "Hostname"
    }
  }
}

sendgrid_create_inbound_parse_webhook

Create an inbound parse webhook.

Note: You must configure MX records for the hostname to point to mx.sendgrid.net.

Args:

hostname: Domain to receive emails on (e.g., parse.example.com)
url: Webhook URL to receive parsed emails
spamCheck: Check for spam before parsing
sendRaw: Send raw MIME message instead of parsed

Returns: The created webhook configuration.

{
  "type": "object",
  "required": [
    "hostname",
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Webhook URL"
    },
    "sendRaw": {
      "type": "boolean",
      "default": false,
      "description": "Send raw MIME"
    },
    "hostname": {
      "type": "string",
      "description": "Hostname/domain"
    },
    "spamCheck": {
      "type": "boolean",
      "default": false,
      "description": "Enable spam check"
    }
  }
}

sendgrid_update_inbound_parse_webhook

Update an inbound parse webhook.

Args:

hostname: Hostname to update
url: New webhook URL
spamCheck: Enable spam check
sendRaw: Send raw MIME

Returns: The updated webhook configuration.

{
  "type": "object",
  "required": [
    "hostname"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "New URL"
    },
    "sendRaw": {
      "type": "boolean",
      "description": "Send raw"
    },
    "hostname": {
      "type": "string",
      "description": "Hostname"
    },
    "spamCheck": {
      "type": "boolean",
      "description": "Spam check"
    }
  }
}

sendgrid_delete_inbound_parse_webhook

Delete an inbound parse webhook.

Args:

hostname: Hostname to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "hostname"
  ],
  "properties": {
    "hostname": {
      "type": "string",
      "description": "Hostname"
    }
  }
}