add_suppression
Add Suppression
Add an email address to a suppression list (bounce, complaint, or unsubscribe). Once suppressed, Mailgun will stop delivering emails to that address for the specified domain.
add_suppression
Add an email address to a suppression list (bounce, complaint, or unsubscribe). Once suppressed, Mailgun will stop delivering emails to that address for the specified domain.
get_events
Query Mailgun's legacy Events API for a domain. Returns delivery, open, click, bounce, complaint, and other email events. Filter by event type, recipient, sender, subject, date range, and more. Prefer the Query Logs tool for current delivery/debug logging unless you specifically need the legacy Events API.
update_mailing_list
Update an existing mailing list's properties including name, description, access level, and reply preference.
delete_domain
Delete a sending domain from Mailgun. This permanently removes the domain and all associated data.
list_mailing_lists
List all mailing lists in the account. Returns list addresses, names, member counts, and access levels.
list_mailing_list_members
List members of a mailing list. Can filter by subscription status.
verify_domain
Trigger DNS verification for a domain. Run this after configuring DNS records to verify SPF, DKIM, and MX settings. Returns the current verification status of each DNS record.
get_template
Get a specific email template with its active version content. Use to review template content and configuration before sending.
create_webhook
Create a webhook for a specific event type on a domain. Mailgun will POST event data to the specified URL when events of the given type occur.
update_domain_tracking
Update tracking settings for a domain. Configure open tracking, click tracking, or unsubscribe tracking individually.
create_domain
Create a new sending domain in Mailgun. Returns the domain details and DNS records that need to be configured. After creation, set up the returned DNS records and use the verify domain tool to complete setup.
remove_mailing_list_member
Remove a member from a mailing list.
create_mailing_list
Create a new mailing list. Mailing lists can be used as recipients when sending messages. Members can be added after creation.
list_suppressions
List suppressed email addresses for a domain. Retrieves bounces, complaints, or unsubscribes depending on the type selected. Suppressed addresses are blocked from receiving further emails to protect sending reputation.
add_mailing_list_member
Add a new member to a mailing list or update an existing member using the upsert option.
validate_email
Validate an email address in real-time using Mailgun's Email Validation API. Checks if the address is deliverable, identifies disposable and role-based addresses, and provides a risk assessment.
get_stats
Get email sending statistics from Mailgun's legacy Stats API for a domain. Returns aggregate counts for events like accepted, delivered, failed, opened, clicked, unsubscribed, and complained over a time range. Prefer the Query Metrics tool for current analytics unless you specifically need the legacy Stats API.
create_template_version
Create a new version of an existing template. Templates support versioning to allow content changes while preserving previous versions.
get_domain
Get detailed information about a specific domain including DNS records and verification status. Use to check if DNS is properly configured for sending.
list_webhooks
List all configured webhooks for a domain. Shows which event types have webhook URLs configured.
list_templates
List all email templates for a domain. Templates are reusable email content with variable substitution support.
delete_webhook
Delete a webhook for a specific event type on a domain.
remove_suppression
Remove an email address from a suppression list (bounce, complaint, or unsubscribe). This re-enables delivery to the address.
update_route
Update an existing inbound email route's expression, actions, priority, or description.
list_domains
List all sending domains in the Mailgun account. Returns domain names, states, and configuration. Use to discover available domains for sending or to check domain verification status.
send_email
Send an email through Mailgun. Supports plain text, HTML, and template-based emails with personalization. Can send to up to 1,000 recipients per call with individual personalization via recipient variables. Supports scheduling, tracking options, tags for analytics, custom headers, and reply-to addresses.
delete_template
Delete an email template and all its versions permanently.
delete_mailing_list
Delete a mailing list and all its members permanently.
create_route
Create a new inbound email route. Routes match incoming emails using expressions and execute actions like forwarding to a URL or email, storing, or stopping. **Expression types:** - `match_recipient("[email protected]")` - match specific recipient - `match_header("subject", ".*support.*")` - match header with regex - `catch_all()` - match any unmatched message **Action types:** - `forward("http://myapp.com/incoming")` - forward to URL - `forward("[email protected]")` - forward to email - `store(notify="http://myapp.com/notify")` - store and optionally notify - `stop()` - stop further route processing
delete_route
Delete an inbound email route permanently.
create_template
Create a new email template for a domain. Optionally include initial content which creates the first version automatically. Templates support Handlebars variable substitution with helpers like `if`, `unless`, `each`, and `with`.
list_routes
List all inbound email routes. Routes define rules for handling incoming emails by matching recipient addresses or headers, then forwarding, storing, or stopping processing.
get_domain_tracking
Get the current tracking settings for a domain. Shows whether open tracking, click tracking, and unsubscribe tracking are enabled.
update_template
Update a domain-level Mailgun template's metadata. Use template version tools to update content or active version.
get_stored_message
Retrieve a message stored by Mailgun from a storage key found in events, logs, or inbound route store actions. The stored message payload is returned as a JSON attachment, with metadata in the tool output.
delete_template_version
Delete a specific version from a Mailgun domain-level template.
add_allowlist_entry
Add an email address or domain to Mailgun's allowlist for a domain. Allowlisted values are prevented from being added to the bounce suppression list.
update_template_version
Update a domain-level Mailgun template version's content, comment, or active status.
remove_allowlist_entry
Remove an email address or domain from Mailgun's allowlist for a domain.
get_mailing_list
Get one Mailgun mailing list by address, including access level, reply preference, and member count.
list_template_versions
List versions for a domain-level Mailgun template. Use before selecting, updating, activating, or deleting a specific version.
update_webhook
Replace the webhook URL list for a Mailgun domain event type with a new URL.
list_allowlist
List Mailgun allowlist entries for a domain. Allowlisted addresses or domains are protected from being added to bounce suppressions, which is useful for test and controlled-recipient workflows.
query_metrics
Query Mailgun's current Metrics API for account or domain analytics. Use this for current reporting instead of the legacy Stats API when you need flexible dimensions, filters, rates, and aggregate metrics.
update_mailing_list_member
Update a Mailgun mailing list member's display name, custom variables, or subscription status.
get_template_version
Get a specific version of a domain-level Mailgun template, including its content and active status.
get_webhook
Get configured webhook URLs for one Mailgun domain event type.
get_mailing_list_member
Get a specific member from a Mailgun mailing list, including subscription status and custom variables.
query_logs
Query Mailgun's current Logs API for account event logs. Use this for current delivery/debug logging instead of the legacy Events API when you need pagination, totals, or richer log records.
Send, receive, and track transactional and marketing emails via Mailgun. Manage sending domains, tracking settings, inbound routes, suppressions, allowlists, mailing lists, reusable templates, current logs and metrics, legacy events and stats, stored messages, validation, and domain webhook notifications.
Common questions about connecting Mailgun to AI agents with Metorial.