Name: Mailgun
Author: mailgun

LABSCO SUMMARY

The whole Mailgun API, not just a send button.

Because the tools are generated from Mailgun's API, the coverage is unusually complete — sending is one tool among domains, routes, templates, suppression lists and analytics — so an assistant can both send mail and manage the account around it. The tradeoff is the naming: tools carry their HTTP path (post-v3-domain-messages), so the model leans on the descriptions rather than friendly names, but the analytics and suppression coverage is what a bare SMTP send cannot give you.

What it is

Mailgun's official server, generated from its API: 74 tools covering sending, domains and their tracking, webhooks, routes, mailing lists, templates, suppression lists, and analytics. Tool names follow the HTTP verb and API path (for example post-v3-domain-messages sends an email).

What you get

Sending and retrieval: post-v3-domain-messages sends an email, get-v3-domains-domain-messages-storage_key retrieves a stored one, and post-v3-domains-domain-messages-storage_key resends it
Domain management: get-v4-domains and get-v4-domains-name, put-v4-domains-name-verify to verify a domain, and get-v3-domains-name-sending_queues for queue status
Tracking configured per domain — get-v3-domains-name-tracking plus put-v3-domains-name-tracking-click, -open and -unsubscribe
Webhooks and routes: create and read domain webhooks by type, and get-v3-routes, get-v3-routes-id and put-v3-routes-id to manage inbound routing
Deliverability hygiene: read and manage bounces, unsubscribes, complaints and whitelists (get-v3-domain-bounces, get-v3-domain-unsubscribes, get-v3-domain-complaints, get-v3-domain-whitelists) by address or in full
Analytics and stats: get-v3-stats-total and the filtered and per-domain variants, aggregates by provider, device and country, and the v1 analytics endpoints post-v1-analytics-metrics, post-v1-analytics-usage-metrics and post-v1-analytics-logs
Templates versioned: get and create domain templates, and get/create/update their versions
Mailing lists: get-v3-lists, post-v3-lists to create one, and the list-member tools, plus tag stats and IP management
Address validation via the validate tool

Requirements

A Mailgun account and API key in MAILGUN_API_KEY from your API security settings. Node, run as npx @mailgun/mcp-server over stdio. If your account is in Mailgun's EU region, set MAILGUN_API_REGION=eu; it defaults to us.

Setup effort

One command plus a key — npx -y @mailgun/mcp-server, then supply credentials

See installation options

USE CASES

01

Sending and following up on an email

Send the message, and if it needs to go again, retrieve the stored copy and resend it rather than rebuilding it.

post-v3-domain-messagesget-v3-domains-domain-messages-storage_keypost-v3-domains-domain-messages-storage_key

02

Getting a sending domain live

Read the domain, verify it, and set its click, open and unsubscribe tracking so the messages you send are measured.

get-v4-domains-nameput-v4-domains-name-verifyput-v3-domains-name-tracking-click

03

Keeping your list clean

Read the bounces, complaints and unsubscribes for a domain so you stop mailing addresses that damage your reputation.

get-v3-domain-bouncesget-v3-domain-complaintsget-v3-domain-unsubscribes

04

Reporting on how mail performed

Pull total stats and break them down by provider, device and country, or query the analytics metrics and logs directly.

get-v3-stats-totalget-v3-domain-aggregates-providerspost-v1-analytics-metrics

74 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`get_inbox_placement_result`

Get Result Details

BEFORE YOU INSTALL

What to know first

Tools you get

74 tools when we connected. --tags (or MAILGUN_MCP_TAGS) limits registration to send, validate, optimize or inspect tools; validate,inspect leaves only a handful. There are no delete operations, only reads and updates.

Requires

npx on PATH
Node.js
MAILGUN_API_KEY in your environment

CONTEXT COST

Heavy Standing cost

Rated by the size of the 74 tool definitions that ride along on every turn, not by how many there are

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @mailgun/mcp-server

MCP Clients

Claude Code

CLAUDE CODE · TERMINAL

claude mcp add mailgun -e MAILGUN_API_KEY=<YOUR_MAILGUN_API_KEY> -- npx -y @mailgun/mcp-server

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": [
        "-y",
        "@mailgun/mcp-server"
      ],
      "env": {
        "MAILGUN_API_KEY": "<YOUR_MAILGUN_API_KEY>",
        "MAILGUN_API_REGION": "us"
      }
    }
  }
}

Cursor, Windsurf, Gemini CLI

JSON

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": [
        "-y",
        "@mailgun/mcp-server"
      ],
      "env": {
        "MAILGUN_API_KEY": "<YOUR_MAILGUN_API_KEY>"
      }
    }
  }
}

Codex

CODEX · TERMINAL

codex mcp add mailgun \
  --env MAILGUN_API_KEY=<YOUR_MAILGUN_API_KEY> \
  -- npx -y @mailgun/mcp-server

VS Code

VS CODE · JSON

{
  "servers": {
    "mailgun": {
      "command": "npx",
      "args": [
        "-y",
        "@mailgun/mcp-server"
      ],
      "env": {
        "MAILGUN_API_KEY": "<YOUR_MAILGUN_API_KEY>"
      }
    }
  }
}

Any MCP client — local build

ANY MCP CLIENT — LOCAL BUILD · TERMINAL

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm run build

ANY MCP CLIENT — LOCAL BUILD · JSON

{
  "mcpServers": {
    "mailgun": {
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_MAILGUN_MCP_SERVER>/dist/mailgun-mcp.js"
      ],
      "env": {
        "MAILGUN_API_KEY": "<YOUR_MAILGUN_API_KEY>"
      }
    }
  }
}

Mailgun

The whole Mailgun API, not just a send button.

What it is

What you get

Requirements

Setup effort

Sending and following up on an email

Getting a sending domain live

Keeping your list clean

Reporting on how mail performed

74 tools

get_inbox_placement_result

get_metrics_summary

get_preview_result

get-v1-bounce-classification-stats

get-v3-domain-aggregates-countries

get-v3-domain-aggregates-devices

get-v3-domain-aggregates-providers

get-v3-domain-bounces

get-v3-domain-bounces-address

get-v3-domain-complaints

get-v3-domain-complaints-address

get-v3-domain-stats-total

get-v3-domain-tag

get-v3-domain-tag-stats

get-v3-domain-tag-stats-aggregates

get-v3-domain-tags

get-v3-domain-templates

get-v3-domain-templates-template

get-v3-domain-templates-template-versions

get-v3-domain-templates-template-versions-version

get-v3-domain-unsubscribes

get-v3-domain-unsubscribes-address

get-v3-domain-whitelists

get-v3-domain-whitelists-value

get-v3-domains-domain-limits-tag

get-v3-domains-domain-messages-storage_key

get-v3-domains-domain-tag-countries

get-v3-domains-domain-tag-devices

get-v3-domains-domain-tag-providers

get-v3-domains-domain-webhooks

get-v3-domains-domain-webhooks-webhook

get-v3-domains-name-sending_queues

get-v3-domains-name-tracking

get-v3-ip_pools

get-v3-ip_pools-pool_id

get-v3-ip_pools-pool_id-domains

get-v3-ips

get-v3-ips-ip

get-v3-ips-ip-domains

get-v3-lists

get-v3-lists-list_address

get-v3-lists-list_address-members

get-v3-lists-list_address-members-member_address

get-v3-routes

get-v3-routes-id

get-v3-stats-filter

get-v3-stats-total

get-v3-stats-total-domains

get-v4-domains

get-v4-domains-name

get-v5-accounts-limit-custom-monthly

get-v5-accounts-subaccounts-ip_pools-all

post-v1-analytics-logs

post-v1-analytics-metrics

post-v1-analytics-usage-metrics

post-v2-bounce-classification-metrics

post-v3-domain-messages

post-v3-domain-templates

post-v3-domain-templates-template-versions

post-v3-domains-domain-messages-storage_key

post-v3-domains-domain-webhooks

post-v3-lists

post-v3-lists-list_address-members

put-v3-domain-templates-template

put-v3-domain-templates-template-versions-version

put-v3-domains-domain-webhooks-webhook

put-v3-domains-name-tracking-click

put-v3-domains-name-tracking-open

put-v3-domains-name-tracking-unsubscribe

`get_inbox_placement_result`

`get_metrics_summary`

`get_preview_result`

`get-v1-bounce-classification-stats`

`get-v3-domain-aggregates-countries`

`get-v3-domain-aggregates-devices`

`get-v3-domain-aggregates-providers`

`get-v3-domain-bounces`

`get-v3-domain-bounces-address`

`get-v3-domain-complaints`

`get-v3-domain-complaints-address`

`get-v3-domain-stats-total`

`get-v3-domain-tag`

`get-v3-domain-tag-stats`

`get-v3-domain-tag-stats-aggregates`

`get-v3-domain-tags`

`get-v3-domain-templates`

`get-v3-domain-templates-template`

`get-v3-domain-templates-template-versions`

`get-v3-domain-templates-template-versions-version`

`get-v3-domain-unsubscribes`

`get-v3-domain-unsubscribes-address`

`get-v3-domain-whitelists`

`get-v3-domain-whitelists-value`

`get-v3-domains-domain-limits-tag`

`get-v3-domains-domain-messages-storage_key`

`get-v3-domains-domain-tag-countries`

`get-v3-domains-domain-tag-devices`

`get-v3-domains-domain-tag-providers`

`get-v3-domains-domain-webhooks`

`get-v3-domains-domain-webhooks-webhook`

`get-v3-domains-name-sending_queues`

`get-v3-domains-name-tracking`

`get-v3-ip_pools`

`get-v3-ip_pools-pool_id`

`get-v3-ip_pools-pool_id-domains`

`get-v3-ips`

`get-v3-ips-ip`

`get-v3-ips-ip-domains`

`get-v3-lists`

`get-v3-lists-list_address`

`get-v3-lists-list_address-members`

`get-v3-lists-list_address-members-member_address`

`get-v3-routes`

`get-v3-routes-id`

`get-v3-stats-filter`

`get-v3-stats-total`

`get-v3-stats-total-domains`

`get-v4-domains`

`get-v4-domains-name`

`get-v5-accounts-limit-custom-monthly`

`get-v5-accounts-subaccounts-ip_pools-all`

`post-v1-analytics-logs`

`post-v1-analytics-metrics`

`post-v1-analytics-usage-metrics`

`post-v2-bounce-classification-metrics`

`post-v3-domain-messages`

`post-v3-domain-templates`

`post-v3-domain-templates-template-versions`

`post-v3-domains-domain-messages-storage_key`

`post-v3-domains-domain-webhooks`

`post-v3-lists`

`post-v3-lists-list_address-members`

`put-v3-domain-templates-template`

`put-v3-domain-templates-template-versions-version`

`put-v3-domains-domain-webhooks-webhook`

`put-v3-domains-name-tracking-click`

`put-v3-domains-name-tracking-open`

`put-v3-domains-name-tracking-unsubscribe`

`put-v3-lists-list_address`

`put-v3-lists-list_address-members-member_address`

`put-v3-routes-id`

`put-v4-domains-name-verify`

`validate_email`