Overview
A Model Context Protocol (MCP) server implementation for Mailgun that lets MCP-compatible AI clients interact with the Mailgun service. The server is intended to be run with Node.js (v18+) and communicates over standard input/output in accordance with MCP tooling. Prerequisites include Node.js, Git, a Mailgun account with an API key, and, for Claude Desktop integration, Claude Desktop itself. Quick Start shows manual installation: clone the repository, install dependencies with npm install, and run the configured Node script mailgun-mcp.js. Claude Desktop can be configured to invoke the MCP server by specifying a command, arguments, and the MAILGUN_API_KEY environment variable. A sample config is provided. The repository also provides a local test workflow (NODE_ENV=test npm test) and sample prompts demonstrating capabilities such as sending an email (subject to account restrictions) and fetching/visualizing delivery statistics. For debugging, the MCP server follows standard debugging practices from the Model Context Protocol docs and communicates over stdio. The project is open to contributions and distributed under the repository license.
Features
MCP over stdio
Communicates with MCP clients over standard input/output (stdio) for simplicity and debugging, in line with Model Context Protocol tooling.
Mailgun API integration
Uses a Mailgun API key to perform email sending operations through the Mailgun service.
Claude Desktop integration support
Configurable to be launched by Claude Desktop; provides a sample config showing command, arguments, and environment variables.
Local testing suite
Includes a local test suite runnable via NODE_ENV=test npm test.
Sample MCP prompts
Provides sample prompts illustrating typical MCP usage, such as sending emails and generating delivery statistics.
Documentation and debugging reference
Guidance references the Model Context Protocol debugging docs for troubleshooting and guidance.
Who Is This For?
- MCP developers:Build MCP-enabled assistants to manage Mailgun email tasks via MCP.
