Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level (debug, info, warn, error) | info |
| READ_ONLY | No | Enable read-only mode (true/false) | true |
| MCP_SERVER_NAME | No | Server name for identification | sendgrid-mcp |
| REQUEST_TIMEOUT | No | API request timeout in milliseconds | 30000 |
| SENDGRID_API_KEY | Yes | Your SendGrid API key (starts with SG.) | |
| MCP_SERVER_VERSION | No | Server version | 1.0.0 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| sendgrid_automation_help | Get help with SendGrid marketing automations |
| sendgrid_campaign_help | Get help with SendGrid single send campaigns |
| sendgrid_contacts_help | Get help with managing SendGrid contacts and lists |
| sendgrid_suppressions_help | Get help with managing SendGrid suppression lists |
| sendgrid_settings_help | Get help with SendGrid account settings and configuration |
| sendgrid_mail_send_help | Get help with sending emails through SendGrid |
| sendgrid_list_management_help | Get help with managing SendGrid email lists |
| sendgrid_contact_crud_help | Get help with creating, reading, updating, and deleting contacts |
| sendgrid_sender_management_help | Get help with managing SendGrid sender identities |
| sendgrid_custom_fields_help | Get help with managing SendGrid custom field definitions |
| sendgrid_update_list_help | Get help with updating, renaming, or modifying SendGrid email lists |
| sendgrid_segment_management_help | Get help with managing SendGrid segments - creating, updating, and deleting dynamic contact segments |
| sendgrid_stats_help | Get help with analyzing SendGrid email performance and statistics across multiple dimensions |
| sendgrid_templates_help | Get help with creating, managing, and using SendGrid dynamic email templates with HTML content and Handlebars |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Marketing Automations | List and manage SendGrid marketing automations |
| Single Sends | List and manage SendGrid single send campaigns |
| Email Lists | Manage email lists and segments |
| Contacts | Manage marketing contacts |
| Suppressions | View suppression lists (bounces, spam reports, unsubscribes) |
| Account Settings | Account profile and settings information |
| Email Statistics | Global email statistics and performance metrics |
| Email Statistics by Browser | Email performance metrics broken down by browser type |
| Email Statistics by Device Type | Email performance metrics broken down by device type (desktop, mobile, tablet) |
| Email Statistics by Geography | Email performance metrics broken down by country and region |
| Email Statistics by Mailbox Provider | Email performance metrics broken down by mailbox provider (Gmail, Outlook, Yahoo, etc.) |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_automations | List all marketing automations |
| open_automation_creator | Open SendGrid automation creator in browser |
| open_automation_editor | Open automation editor for a specific automation |
| list_single_sends | List all single send campaigns |
| open_single_send_creator | Open SendGrid single send creator in browser |
| open_single_send_stats | Open single send stats page for a specific campaign |
| list_email_lists | List all email lists |
| create_email_list | Create a new email list in your SendGrid account |
| update_email_list | Update the properties of an existing email list |
| delete_email_list | Delete an existing email list from your SendGrid account |
| list_segments | List all segments with their parent list relationships |
| open_segment_creator | Open SendGrid segment creator in browser |
| create_contact | Create new contacts in your SendGrid account |
| create_contact_with_lists | Create new contacts and assign them to specific email lists |
| open_csv_uploader | Open SendGrid CSV contact upload page in browser |
| list_custom_fields | List all custom fields |
| create_custom_field | Create a new custom field for contacts |
| update_custom_field | Update an existing custom field definition |
| delete_custom_field | Delete a custom field definition |
| list_senders | List all verified senders |
| create_sender | Create a new sender identity |
| delete_contact | Delete contacts by IDs |
| remove_contact_from_lists | Remove contacts from a specific email list |
| get_contact | Get detailed information about a specific contact by ID |
| update_contact | Update existing contact information |
| search_contacts | Search for contacts using query conditions without creating a segment |
| search_contacts_by_emails | Search for specific contacts by their email addresses |
| list_contacts | List all contacts with optional pagination |
| delete_sender | Delete a verified sender identity |
| update_segment | Update an existing segment's name or query criteria |
| delete_segment | Delete an existing segment |
| send_mail | Send an email using SendGrid Mail Send API |
| get_scopes | Get available permission scopes for API keys |
| get_global_stats | Retrieve global email statistics for your SendGrid account |
| get_stats_by_browser | Retrieve email statistics grouped by browser type |
| get_stats_by_client_type | Retrieve email statistics grouped by email client type |
| get_stats_by_device_type | Retrieve email statistics grouped by device type (desktop, mobile, tablet) |
| get_stats_by_country | Retrieve email statistics grouped by geographic location |
| get_stats_by_mailbox_provider | Retrieve email statistics grouped by mailbox provider (Gmail, Outlook, Yahoo, etc.) |
| get_category_stats | Retrieve email statistics for specific categories (available for previous 13 months only) |
| get_subuser_stats | Retrieve email statistics for specific subusers |
| get_stats_overview | Get a comprehensive overview of email statistics across multiple dimensions |
| list_templates | Retrieve all transactional templates (legacy and dynamic) |
| get_template | Retrieve details of a specific template including all versions |
| create_template | Create a new dynamic transactional template |
| update_template | Update the name of an existing template |
| delete_template | Delete a template and all its versions |
| create_template_version | Create a new version of a template with HTML content and settings |
| get_template_version | Retrieve details of a specific template version |
| update_template_version | Update the content and settings of a template version |
| delete_template_version | Delete a specific version of a template |
| create_html_template | Create a new template with HTML content in one step - perfect for AI-generated designs |
| open_template_editor | Open the SendGrid template editor in browser for visual editing |