개요

A Model Context Protocol (MCP) Server for Mailgun that gives AI Agents 실질적인, 워크플로우 중심 인터페이스 이메일, 진단 Deliverability 및 계정 운영을 관리합니다.

[!노트] 이 MCP 서버는 당신의 기계에 국부적으로 실행하고 stdio에 커뮤니케이션합니다. Mailgun은 현재 이 서버의 호스팅 버전을 제공하지 않습니다.

기능

-Messaging - 이메일 보내기, 저장된 메시지 검색, 메시지 삭제

• Domains - 도메인 세부 정보보기, DNS 구성 확인, 추적 설정 관리 (클릭, 열림, 취소)
• Webhooks - 목록, 생성 및 업데이트 이벤트 webhooks
• Routes - View and update inbound 이메일 여정 규칙 -Mailing Lists — 생성,보기, 업데이트 메일링 리스트 및 회원
• Templates — Create, view, and update email Templates with versioning
• Analytics - 메트릭, 사용 메트릭, 로그 전송
• Stats - 도메인, 태그, 공급자, 장치 및 국가 별 집단 통계보기
• Suppressions - 반송, 취소, 불만 및 수당 항목보기
• IPs & IP Pools - IP 할당 및 전용 IP 풀 구성 보기

Mailgun MCP Server

Overview

A Model Context Protocol (MCP) server for Mailgun that gives AI agents a practical, workflow-oriented interface to send email, diagnose deliverability, and manage account operations.

[!NOTE] This MCP server runs locally on your machine and communicates over stdio. Mailgun does not currently offer a hosted version of this server.

Capabilities

• Messaging — Send emails, retrieve stored messages, resend messages
• Domains — View domain details, verify DNS configuration, manage tracking settings (click, open, unsubscribe)
• Webhooks — List, create, and update event webhooks
• Routes — View and update inbound email routing rules
• Mailing Lists — Create, view, and update mailing lists and their members
• Templates — Create, view, and update email templates with versioning
• Analytics — Query sending metrics, usage metrics, and logs
• Stats — View aggregate statistics by domain, tag, provider, device, and country
• Suppressions — View bounces, unsubscribes, complaints, and allowlist entries
• IPs & IP Pools — View IP assignments and dedicated IP pool configuration
• Bounce Classification — Analyze bounce types and delivery issues
• Validation — Validate email address deliverability and syntax before sending (validate)
• Optimize (Inbox Placement) — Retrieve inbox placement / seed test results to gauge deliverability (optimize)
• Inspect (Email Preview) — Retrieve email rendering and preview test results across clients (inspect)
• Account Limits — View custom monthly sending limits

The parenthetical labels above (validate, optimize, inspect) are the product tags used by tag filtering. Every other capability is registered under the send tag.

[!NOTE] Tools are limited to read and update operations — no delete operations are exposed, which keeps the blast radius of an unintended action small. See Security Considerations.

How it works

The server is OpenAPI driven. At startup it parses a bundled Mailgun OpenAPI spec and registers a curated allowlist of endpoints as MCP tools, generating each tool’s input schema (via Zod) from the spec. Every tool is annotated with a Mailgun product tag (send, validate, optimize, or inspect). All matching tools are registered up front — there is no lazy or on demand loading. Tag filtering is applied at startup to scope which tools get registered, so a given workflow can expose only the products it needs.

Prerequisites

• Node.js (v20.12 or higher)