@kikin/mailsac-mcp
v1.0.1
Published
MCP server for Mailsac email testing service
Maintainers
Readme
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
- Mailsac Account: Sign up at mailsac.com
- API Key: Get your API key from Mailsac API Keys page
- Node.js: Version 16 or higher
Installation
Option 1: Install from npm (Recommended)
npm install -g @kikin/mailsac-mcpOption 2: Clone and build from source
- Clone this repository:
git clone <repository-url>
cd mailsac-mcp- Install dependencies:
npm install- Compile TypeScript:
npx tscUsage 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_hereUsage 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-mcpExample 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.tsThis 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.jsWatch Mode
npx tsc --watchFastMCP Inspector
Use the FastMCP inspector for interactive development:
npx fastmcp inspect index.tsLicense
MIT - Same as the Mailsac TypeScript SDK
