# Mailgun MCP events

Mailgun's webhook events are available to agents as MCP events through Hookdeck Event Gateway.

These pages cover event webhooks, which report on email you send. Inbound Routes, which post email you receive through `forward()` and `store()` actions, have no event types and are covered in [the Production guide](/webhooks/mailgun/guide-duplicates-ordering-retries-timeouts#inbound-routes).

Agent skill: `npx skills add hookdeck/webhook-skills --skill mailgun-webhooks` ([details](https://hookdeck.com/webhooks/mailgun/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Mailgun's official docs](https://documentation.mailgun.com/docs/mailgun/user-manual/events/event-structure.md).

[Overview](https://hookdeck.com/webhooks/mailgun) · [Webhook events (9)](https://hookdeck.com/webhooks/mailgun/events) · [MCP events](https://hookdeck.com/webhooks/mailgun/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/mailgun/verify) · [Production guide](https://hookdeck.com/webhooks/mailgun/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/mailgun/skill)

## Mailgun's MCP server

Mailgun's MCP server (`@mailgun/mcp-server`) runs locally and lets an AI assistant call the Mailgun API, for example to send email, check delivery stats, or list and change webhook configurations. Its tools don't deliver Mailgun's events. To get those into an agent, subscribe it through Hookdeck Event Gateway, as described below. [Mailgun's MCP docs](https://documentation.mailgun.com/docs/mailgun/mcp)

## How to subscribe

1. Connect your agent to Hookdeck's MCP server ([MCP Events bridge](https://hookdeck.com/blog/mcp-events-bridge)).
2. Point your Mailgun webhook at a Hookdeck source.
3. Your agent lists the available events and subscribes to the ones it needs.

## Events

| Webhook event | MCP event |
|---|---|
| [accepted](https://hookdeck.com/webhooks/mailgun/events#accepted) | `mailgun.accepted` |
| [delivered](https://hookdeck.com/webhooks/mailgun/events#delivered) | `mailgun.delivered` |
| [failed](https://hookdeck.com/webhooks/mailgun/events#failed) | `mailgun.failed` |
| [permanent_fail](https://hookdeck.com/webhooks/mailgun/events#permanent_fail) | `mailgun.permanent_fail` |
| [temporary_fail](https://hookdeck.com/webhooks/mailgun/events#temporary_fail) | `mailgun.temporary_fail` |
| [opened](https://hookdeck.com/webhooks/mailgun/events#opened) | `mailgun.opened` |
| [clicked](https://hookdeck.com/webhooks/mailgun/events#clicked) | `mailgun.clicked` |
| [unsubscribed](https://hookdeck.com/webhooks/mailgun/events#unsubscribed) | `mailgun.unsubscribed` |
| [complained](https://hookdeck.com/webhooks/mailgun/events#complained) | `mailgun.complained` |
---

Not affiliated with Mailgun. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/mailgun.json) · [Report a correction](https://hookdeck.com/contact)
