# Mailgun MCP for AI Agents AI Agent Connect > Mailgun MCP. Manage transactional emails, domain health, and suppression lists from your AI agent. Send high-priority messages, audit DNS records (SPF, DKIM, MX), query delivery stats, and manage bounces or unsubscribes without switching tabs. ## Overview - **Category:** ship-it - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_fgcU2KpO0lr76CoFuRObQFd3sxC2f0VrRcHAcynB/ai-agent-connect - **Tags:** transactional-email, email-infrastructure, delivery-logs, domain-health, suppression-management, smtp-api ## Description The Mailgun MCP connects your email infrastructure to your AI agent so you can manage everything from one place. Managing email delivery usually means jumping between a dashboard, your DNS provider, and a spreadsheet for tracking bounces. It's a lot of context switching. This connection lets you handle all of that directly within your AI client. You can ask your agent to send out a batch of transactional emails or check if your domain's SPF and DKIM records are actually set up correctly. If you see a spike in bounces, you can find out exactly why they're happening and clear out old suppressions so your messages actually reach people. It also makes it way easier to see how your campaigns are performing by pulling real-time stats on opens and clicks. Instead of hunting for specific logs or trying to remember which HTML template you used last month, you just tell your agent what you need. It's a huge time saver for anyone who needs to keep their email delivery running smoothly without the manual overhead. You can find this and hundreds of other integrations in the Vinkius catalog to get your workflow set up in minutes. Developers trying to verify a domain for a new app and growth leads looking for a quick status update on a campaign both benefit from this connection. It removes the friction of manual data entry and tab switching. You get a conversational way to manage your entire mail flow, making it much easier to stay on top of your sender reputation and delivery rates. ## Tools ### list_bounces View all the emails that bounced from your domain. This is useful for identifying inactive audiences or out-of-bounds sending. ### delete_bounce Remove a specific bounced address from your suppression list. This allows you to attempt sending to that address again. ### list_unsubscribes See which email addresses have opted out of your messages. This helps you keep your mailing lists clean and accurate. ### send_email Send a transactional or marketing email through your Mailgun account. You can specify the domain and the message body directly. ### validate_email Check if an email address is actually deliverable before you try to send a message. This helps protect your sender reputation. ### get_domain Retrieve the specific DNS records and details for a Mailgun domain. Use this to check your SPF, DKIM, and MX status. ### list_logs Pull a raw list of events like deliveries, opens, and bounces for a domain. Use this to troubleshoot specific delivery issues. ### get_stats Pull real-time performance data for your specific Mailgun domain. This lets you see how your emails are performing at a glance. ### get_templates See all the HTML Handlebars templates you have stored for your domain. This helps you find the right design for your next message. ### list_domains View every domain currently connected to your Mailgun account. This is a quick way to see your full infrastructure. ## Prompt Examples **Prompt:** ``` Send a transactional email to 'user@example.com' from 'support@mg.domain.com' with subject 'Order Confirmed' ``` **Response:** ``` Dispatching email… I've successfully sent the message to 'user@example.com' via the 'mg.domain.com' domain. The Message ID is '202603271234.abc@mg.domain.com'. Would you like me to monitor the event logs for delivery status? ``` **Prompt:** ``` Check the DNS health for domain 'mg.mycompany.com' ``` **Response:** ``` Retrieving domain details… For 'mg.mycompany.com', SPF and DKIM records are verified and active. However, the MX records are currently marked as 'Unverified'. You may need to update your DNS settings to receive replies. Would you like the exact MX values to add? ``` **Prompt:** ``` List all bounced emails for 'mg.mycompany.com' from the last hour ``` **Response:** ``` Retrieving bounce logs… I've identified 3 bounced addresses: 'old-user@gmail.com' (5.1.1 User unknown), 'invalid-addr@yahoo.com', and 'full-mailbox@outlook.com'. Would you like me to remove 'full-mailbox@outlook.com' from the suppression list so you can try again? ``` ## Capabilities ### Send transactional emails Send high-priority messages directly from your agent. ### Audit DNS records Check SPF, DKIM, and MX records to ensure your domain is set up for deliverability. ### Manage suppression lists Identify and remove bounced or unsubscribed addresses from your active lists. ### Query delivery stats Get real-time data on opens, clicks, and delivery rates for your domains. ### Extract event logs Pull raw data on deliveries, drops, and bounces to troubleshoot failures. ### Validate email addresses Check if an email address is deliverable before you attempt to send a message. ### Retrieve HTML templates Access stored Handlebars templates to keep your messaging consistent. ## Use Cases ### Testing a new signup flow A developer needs to verify a new email trigger. They ask the agent to send_email to a test box and then use list_logs to confirm it hit the inbox. ### Investigating a delivery drop A growth lead notices a drop in opens. They ask the agent to get_stats for the last 24 hours to see if it's a domain-wide issue or a specific campaign. ### Fixing a DNS configuration error A DevOps engineer finds a delivery failure alert. They use get_domain to check if the MX records are still correct or if a DNS change broke things. ### Cleaning up a bounce list A marketing manager wants to re-engage a specific user. They use list_bounces to find why a user failed and then use delete_bounce to clear the suppression. ## Benefits - Stop manual DNS checks: Use get_domain to instantly verify SPF, DKIM, and MX records without logging into your DNS provider. - Faster incident response: Use list_logs to quickly see why emails are dropping or bouncing during a delivery spike. - Clean up your lists: Use delete_bounce to remove specific bounced addresses from your suppression list so you can attempt sending again. - Consistent branding: Use get_templates to pull existing HTML Handlebars templates into your agent's context for every send. - Real-time performance tracking: Use get_stats to pull open and click rates immediately without exporting CSVs. - Better deliverability: Use validate_email to check addresses before you try to send a message to keep your sender reputation high. ## How It Works The bottom line is you get a conversational interface for your entire Mailgun infrastructure. 1. Subscribe to this Connector and get your Mailgun Private API Key. 2. Connect the key to your AI client like Claude or Cursor. 3. Ask your agent to perform tasks like sending emails or checking domain health. ## Frequently Asked Questions **Can the Mailgun MCP send emails for me?** Yes, it lets your AI agent send transactional or marketing emails directly. You just specify the recipient, subject, and body in your conversation. **How does the Mailgun MCP help with email deliverability?** It allows you to instantly check your SPF, DKIM, and MX records. This ensures your domain is properly configured to reach the inbox instead of the spam folder. **Can I use the Mailgun MCP to see why my emails are bouncing?** Yes, you can pull raw event logs to see specific error codes for bounces. This helps you identify if an issue is with the recipient or your own domain health. **Does the Mailgun MCP support my existing HTML templates?** Yes, it can retrieve your stored HTML Handlebars templates. This makes it easy for your agent to use your professional branding for every send. **How do I use the Mailgun MCP to check my DNS settings?** You just ask your agent to check the DNS records for a specific domain. It will pull the current status and tell you if everything is verified. **Can the Mailgun MCP help me clean up my unsubscribed list?** Yes, it can list unsubscribed emails and identify bounced addresses. This helps you keep your mailing lists accurate and compliant. **Is the Mailgun MCP good for checking if an email address is valid?** Yes, it uses the Mailgun Validation API to check if an address is deliverable before you send. This is a great way to protect your sender reputation. **Can I check if my domain's DNS records are correctly configured?** Yes. Use the `get_domain` tool by providing your verified domain name. Your agent will retrieve the status of SPF, DKIM, and MX records, helping you identify if any DNS dependencies are missing or misconfigured. **How do I see which emails have recently bounced from my domain?** The `list_bounces` tool allows your agent to extract the suppression logs for a specific domain. You'll see the email addresses that failed to deliver, providing insights into audience health or sending boundaries. **Can my agent validate an email address before I send a message?** Absolutely. Use the `validate_email` tool to check if an address is valid, deliverable, and doesn't belong to a disposable service. This is perfect for ensuring high-quality data before triggering outbound sends.