What is Mailsac Mcp

mailsac-mcp is an unofficial Model Context Protocol (MCP) server designed to provide access to all major Mailsac API endpoints for email testing and management.

Use cases

Use cases for mailsac-mcp include creating temporary email addresses for testing, managing inboxes for automated testing, validating email addresses in bulk, and setting up email forwarding for testing purposes.

How to use

To use mailsac-mcp, you need to install it via npm or clone the repository. After installation, configure it with your Mailsac API key and integrate it with compatible clients like Claude Code or Claude Desktop.

Key features

Key features of mailsac-mcp include seamless integration with Mailsac’s API, support for various MCP clients, and the ability to perform tasks such as creating email addresses, forwarding emails, and validating email addresses using natural language commands.

Where to use

mailsac-mcp is primarily used in software development and testing environments where email functionalities need to be simulated or managed, such as in applications that require email verification or testing.

Mailsac MCP Server

A comprehensive Model Context Protocol (MCP) server that provides access to all major Mailsac API endpoints for email testing and management.

Prerequisites

1. Mailsac Account: Sign up at mailsac.com
2. API Key: Get your API key from Mailsac API Keys page
3. Node.js: Version 16 or higher

Installation

Option 1: Install from npm (Recommended)

npm install -g @kikin/mailsac-mcp

Option 2: Clone and build from source

1. Clone this repository:

git clone <repository-url>
cd mailsac-mcp

2. Install dependencies:

npm install

3. Compile TypeScript:

npx tsc

Usage with Claude Code

Add this MCP server to Claude Code:

claude mcp add mailsac -s user npx @kikin/mailsac-mcp --env MAILSAC_KEY=your_api_key_here

Usage with Claude Desktop

Add this MCP server to your Claude Desktop configuration file:

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "mailsac": {
      "command": "npx",
      "args": [
        "@kikin/mailsac-mcp"
      ],
      "env": {
        "MAILSAC_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with Other MCP Clients

You can also use this server with any other MCP-compatible client by running:

MAILSAC_KEY=your_api_key_here npx @kikin/mailsac-mcp

Example Usage

Once connected to Claude Desktop, you can use natural language to interact with Mailsac:

"Create a new email address [email protected] and set up forwarding to [email protected]"

"List all messages in the inbox for [email protected]"

"Get the plaintext content of message ID abc123 from [email protected]"

"Validate these email addresses: [[email protected], [email protected]]"

"Delete all messages from the [email protected] inbox"

"Show me the top public email domains by message volume"

Development

This project uses FastMCP for MCP server development.

Development Mode with Inspector

For development with the FastMCP inspector (recommended):

npx fastmcp dev index.ts

This provides:

• Hot reload on file changes
• Web-based inspector at http://localhost:3001
• Interactive tool testing
• Real-time debugging

Alternative: Manual Development

# Compile TypeScript
npx tsc

# Run the server
MAILSAC_KEY=your_api_key_here node index.js

Watch Mode

npx tsc --watch

FastMCP Inspector

Use the FastMCP inspector for interactive development:

npx fastmcp inspect index.ts

License

MIT - Same as the Mailsac TypeScript SDK

Support

• Mailsac Documentation
• Mailsac API Documentation
• MCP Documentation

Related Links

• Mailsac Website
• Mailsac TypeScript SDK