Twilio SendGrid MCP. Manage contacts, bounces, and dispatch campaigns.

Q: How do I check for bounce issues using listbounces?

Run listbounces. The agent will show you a record of all failed emails, including the specific error code (e.g., 550 Relay Denied). From there, you can use deletebounce if you confirm the address is valid.

Q: What's the difference between listmarketingcontacts and listmarketinglists?

The distinction is contacts vs. groups. listmarketingcontacts gives a raw list of every single person. listmarketinglists shows you the segmented buckets (like 'Tier 1 Clients' or 'Q3 Leads') that contain those people.

Q: Can I use dispatchemail to send a test email?

Yes, absolutely. You tell your agent to run dispatchemail with the target recipients and subject line. It sends the fully authenticated HTML email through SendGrid's relay.

Q: Do I need to worry about spam complaints? How does listspamreports help?

Yes, you should check this regularly. Running listspamreports gives you a log of user-reported complaints. This is an early warning system that tells you when your content or sender reputation needs immediate attention.

Q: When sending an email with dispatchemail, what are the mandatory setup requirements?

You must use a verified sender email in the "fromemail" field. This step is required for deliverability and prevents emails from being flagged as spam, so always ensure your credentials are pre-verified.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Just plug in your AI agents and start using Vinkius.

Twilio SendGrid MCP Server gives your AI agent direct API access to manage email campaigns, clean contact lists, and audit deliverability.

Dispatch authenticated HTML emails, check suppression bounce records, or grow marketing directories using specific tools like `dispatch_email` and `create_marketing_contact`. It's full-cycle marketing automation right through the chat interface.

What your AI agents can do

Create marketing contact

Adds a new contact to your marketing directory, merging data if the person already exists.

Delete bounce

Removes a specific address from the bounce suppression list after validating it should be active again.

Delete spam report

Use with caution — sending to users who report spam can damage your sender reputation.

Remove an email from the spam report suppression list

+ 13 more capabilities included

Send authenticated emails

Use the dispatch_email tool to send outbound HTML campaigns from a verified sender address.

Audit failed deliveries

Run list_bounces to view all bounced email records and use delete_bounce to remove specific addresses from the suppression list.

Manage contact data

Use create_marketing_contact to add or update subscriber details, and list_marketing_contacts to view the entire directory.

Inspect email templates

List all available transactional designs with list_dynamic_templates, then retrieve a specific template's structure using get_template_details.

Ask AI about this MCP

Ask ChatGPT

Ask Claude

Ask Perplexity

Supported MCP Clients

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

Free for Subscribers

Waiting for input…

AI Agent

Twilio SendGrid MCP Server: 10 Tools for Email Ops

Use these tools to automate every step of your marketing lifecycle, from list hygiene and contact creation to authenticated campaign dispatch.

create019d7605

create marketing contact

Adds a new contact to your marketing directory, merging data if the person already exists.

delete019d7605

delete bounce

Removes a specific address from the bounce suppression list after validating it should be active again.

delete019e9a8f

delete spam report

Use with caution — sending to users who report spam can damage your sender reputation. Remove an email from the spam report suppression list

dispatch019d7605

dispatch email

Sends an authenticated outbound email campaign via SendGrid's SMTP relay to specified recipients.

get019e9a8f

get delivery stats

Use YYYY-MM-DD format. Get global email delivery statistics

get019d7605

get template details

Retrieves the specific structure and content details for a single transaction template ID.

list019e9a8f

list blocked emails

Different from bounces — blocks are typically temporary server-level rejections. List all blocked email addresses

list019d7605

list bounces

Gathers a list of all email addresses that have recently failed delivery (hard bounces).

list019d7605

list dynamic templates

Lists every available dynamic transactional template stored in your account.

list019d7605

list global unsubscribes

Retrieves a full list of all users who have unsubscribed from marketing communications globally.

list019d7605

list marketing contacts

Lists every current contact record in your primary marketing directory.

list019d7605

list marketing lists

Retrieves a list of all segmented marketing contact groups you maintain.

list019e9a8f

list single sends

List all marketing single-send campaigns

list019d7605

list spam reports

Lists records detailing emails that have been reported as spam by users.

list019e9a8f

list verified senders

Only verified senders can be used in the from_email field. List all verified sender identities

search019e9a8f

search contact by email

Returns full contact profile including custom fields, lists, and segments. Look up a marketing contact by email address

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Twilio SendGrid, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 4,700+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

What you can do with this MCP connector

Your AI agent gives you direct API access to manage every part of your email campaign lifecycle through Twilio SendGrid. You don't gotta export CSVs or stare at dashboards; your agent handles list hygiene, sending campaigns, and auditing bounces right from the chat interface.

Sending Campaigns

You can run outbound HTML campaigns using dispatch_email. This tool sends authenticated emails via SendGrid’s SMTP relay straight to specified recipients. You dictate the message content and hit send; it queues up instantly for delivery.

Auditing Delivery Status

To check on failed deliveries, you'll run list_bounces to gather a complete list of every email address that bounced hard. If you know an address was wrongly suppressed, you use delete_bounce to remove it from the bounce suppression list after confirming it's active again. For compliance tracking, your agent can pull all records detailing emails reported as spam using list_spam_reports.

You can also view every user who unsubscribed globally by calling list_global_unsubscribes, giving you a clear picture of your opted-out audience.

Managing Contact Data

When it comes to list hygiene, the agent lets you maintain your core directory using list_marketing_contacts to see every current subscriber record. Need to add someone new or update details? Use create_marketing_contact; this tool handles adding a new contact while making sure it merges data if that person already exists in your system.

You can also pull a list of all segmented marketing groups you've set up by running list_marketing_lists.

Inspecting Templates

Before you fire off any major send, you need to check the template structure first. Your agent pulls every available dynamic transactional design stored in your account using list_dynamic_templates. Once you identify a specific ID, you use get_template_details to retrieve that exact template's structure and content details. This whole setup lets your AI client manage full-cycle marketing automation.

This server gives your agent the power to take action: dispatching emails with dispatch_email, cleaning up data with delete_bounce, growing lists with create_marketing_contact, viewing every detail with get_template_details, and pulling critical reports like bounce records using list_bounces or spam complaints via list_spam_reports.

How Twilio SendGrid MCP Works

1 Enable the SendGrid component in your client environment and supply an encrypted API Key with necessary permissions.
2 Ask your agent to perform a task (e.g., 'List all bounced emails').
3 The agent calls the specific tool (list_bounces), processes the data, and gives you actionable results or executes corrective actions.

The bottom line is: Your AI client interacts with your SendGrid account using direct API calls, eliminating manual dashboard navigation for core marketing tasks.

Who Is Twilio SendGrid MCP For?

This is for the Marketing Ops Manager who's tired of cross-referencing spreadsheets and manually checking bounce logs. It’s also for Software Developers building internal tools that need reliable, API-driven email communication without writing boilerplate SendGrid code.

Marketing Operations Specialist

Needs to run list audits, clean up hard bounces using list_bounces and delete_bounce, or quickly check deliverability for a critical campaign send.

Software Developer

Builds microservices that need to dispatch emails (dispatch_email) or validate contact schemas before sending data downstream, without needing full SendGrid SDK integration.

Customer Success Manager

Requires instant verification of a key customer's email status—is it bouncing, unsubscribed, or deliverable?

What Changes When You Connect

Clean your list instantly. Instead of manual auditing, use list_bounces to find dead addresses and then run delete_bounce on valid ones. This keeps your sender reputation healthy.
Automate contact growth. Whenever a conversation generates an email address, the agent runs create_marketing_contact, ensuring every new lead is immediately added or updated in your CRM records.
Verify campaigns before sending. Use list_dynamic_templates followed by get_template_details. You can check complex HTML structures against their rules without building a test email manually.
Know exactly who opted out. The agent runs list_global_unsubscribes, giving you a single source of truth regarding compliance and unsubscribed users, preventing accidental sends.
Track deliverability issues. Use list_spam_reports to see what complaints are coming in. This gives early warnings that your content or sender reputation is failing.

Real-World Use Cases

Initial campaign send fails due to old addresses.

A large client needs to run a blast, but they suspect the list has junk data. They ask their agent: 'Audit our bounces and prep the list.' The agent runs list_bounces, finds 120 invalid records, prompts you for confirmation, and then executes delete_bounce on them before initiating the final dispatch_email.

Building a new lead capture form.

A marketing team needs to integrate a sign-up widget. Instead of manual CSV imports, they ask their agent to run through the data flow: it uses create_marketing_contact for every submission and then runs list_marketing_lists to verify which segment the new contact belongs to.

Debugging a template structure.

A developer is testing an HTML email layout. They first call list_dynamic_templates to see available designs, then use get_template_details on ID XYZ to verify that the <h1 style='color:red'> tags render correctly before sending a test via dispatch_email.

Investigating list health after an outage.

The team notices delivery metrics dropped. They ask their agent to check for compliance issues, running both list_spam_reports and list_global_unsubscribes. The agent synthesizes the data, telling them if the drop was due to spam complaints or a mass opt-out.

The Tradeoffs

Trying to update contact fields manually.

The user tries to tell their agent: 'Update John Doe's phone number.' The system fails because there is no direct update_contact tool available in the current manifest.

→ If you need to change a core field, run list_marketing_contacts first. If the data needs merging or enrichment, use create_marketing_contact; this tool handles updates if the contact already exists.

Assuming list names are enough.

The user only runs list_marketing_lists and assumes that just knowing the segment name is enough to send an email. This fails because you still need to dispatch the message.

→ Always pair listing with action. After running list_marketing_lists, use dispatch_email specifying the recipients or template associated with that list.

Sending emails without checking bounces.

The team launches a major campaign and ignores bounce data, leading to high failure rates and damaged sender reputation. They only rely on their initial list_marketing_contacts snapshot.

→ Before any large send, run list_bounces. Use the results to identify bad addresses, then execute delete_bounce before calling dispatch_email.

When It Fits, When It Doesn't

Use this MCP Server if your process requires a full cycle: validation -> action -> cleanup. Specifically, use it when you need to confirm list health (using list_bounces, list_spam_reports) before performing any send (dispatch_email). You must run the agent through data retrieval tools like list_marketing_contacts and then decide on a corrective action using delete_bounce. Don't use this if you only need to read basic metrics; for pure reporting, simpler list-reading servers might suffice. If your primary goal is just contact acquisition without sending, stick to create_marketing_contact; don't worry about the send tools until you have a validated list.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Twilio SendGrid. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 16 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

create_marketing_contact delete_bounce delete_spam_report dispatch_email get_delivery_stats get_template_details list_blocked_emails list_bounces list_dynamic_templates list_global_unsubscribes list_marketing_contacts list_marketing_lists list_single_sends list_spam_reports list_verified_senders search_contact_by_email

Checking deliverability used to mean exporting CSVs and cross-referencing spreadsheets.

Before this, if your team wanted to know why an email failed, someone had to log into the SendGrid dashboard. They'd navigate to 'Bounces', filter by date range, then manually copy addresses that needed clearing. This process was slow and prone to human error—you could miss critical records.

Now, you just ask your agent: 'What emails bounced this week?' The agent runs `list_bounces`, pulls the specific failure data (like 550 Relay Denied), and tells you exactly which addresses need attention. You get actionable intelligence instantly.

Twilio SendGrid MCP Server: Manage contacts, bounces & delivery

Before connecting this server, every campaign update—whether it was adding a new lead or fixing an old bounce—required multiple logins and API calls written into code. A simple list cleanup meant jumping between 'Contacts', 'Lists', and 'Bounces' sections.

With the MCP Server, all of that complexity is abstracted. You speak natural language to your agent, and it orchestrates the necessary sequence (`list_marketing_lists` -> `create_marketing_contact` -> `dispatch_email`) in one go. It just works.

Common Questions About Twilio SendGrid MCP

How do I check for bounce issues using list_bounces? +

Run list_bounces. The agent will show you a record of all failed emails, including the specific error code (e.g., 550 Relay Denied). From there, you can use delete_bounce if you confirm the address is valid.

What's the difference between list_marketing_contacts and list_marketing_lists? +

The distinction is contacts vs. groups. list_marketing_contacts gives a raw list of every single person. list_marketing_lists shows you the segmented buckets (like 'Tier 1 Clients' or 'Q3 Leads') that contain those people.

Can I use dispatch_email to send a test email? +

Yes, absolutely. You tell your agent to run dispatch_email with the target recipients and subject line. It sends the fully authenticated HTML email through SendGrid's relay.

Do I need to worry about spam complaints? How does list_spam_reports help? +

Yes, you should check this regularly. Running list_spam_reports gives you a log of user-reported complaints. This is an early warning system that tells you when your content or sender reputation needs immediate attention.

When sending an email with `dispatch_email`, what are the mandatory setup requirements? +

You must use a verified sender email in the "from_email" field. This step is required for deliverability and prevents emails from being flagged as spam, so always ensure your credentials are pre-verified.

If I run `create_marketing_contact` multiple times with the same user data, what happens? +

The tool merges existing data if the contact ID already exists. It updates relevant fields rather than creating duplicate records, which keeps your marketing list clean and accurate.

Before running `delete_bounce`, what should I know about suppressing records? +

Be careful; this action is destructive because it permanently removes the suppression record. Only use delete_bounce when you are absolutely certain a specific address needs to be unblocked from spam filters.

What information does `get_template_details` provide about a template's internal code? +

It retrieves granular details, including the full structure and blocks of the chosen template. This lets you inspect the exact HTML markup before deciding to run an outbound campaign.

Can the agent automatically send emails on my behalf? +

Yes. The integration natively wraps the dispatch_email mutation tool. If adequately prompted, the system will formulate HTML payloads and broadcast them assuming you explicitly provide the verified Sender Identity (from_email) corresponding to your account.

How do I remove an email block suppressing one of my clients? +

You don't need to manually interact with the web app anymore. Dictate to the LLM: 'Unblock client@gmail.com from my bounce list'. The agent will instantly leverage delete_bounce removing the suspension logic behind the scenes.

Can I query spam complaints regarding my outgoing templates? +

Absolutely. Utilize the command prompt sequence to call list_spam_reports. It retrieves detailed events pointing precisely to domains triggering those complaints, empowering you to adjust or purge bad contacts dynamically.

View all recipes →