AntiTempMail MCP Server

Model Context Protocol (MCP) server for validating email addresses against temporary/disposable email providers using the AntiTempMail API.

Works with Claude Desktop, Cline, and any MCP-compatible client.

🚀 Quick Start

Installation

npm install -g @antitempmail/mcp-server

Configuration

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "antitempmail": {
      "command": "antitempmail-mcp",
      "env": {
        "ANTITEMPMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cline (VS Code Extension)

Add to Cline's MCP settings:

{
  "mcpServers": {
    "antitempmail": {
      "command": "antitempmail-mcp",
      "env": {
        "ANTITEMPMAIL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Get Your API Key

Sign up at AntiTempMail and get your API key from the Dashboard.

🛠️ Available Tools

check_email

Validate a single email address.

Input:

{
  "email": "[email protected]"
}

Output:

{
  "email": "[email protected]",
  "isTemporary": true,
  "domain": "tempmail.com",
  "provider": "TempMail",
  "risk": "high",
  "confidence": 98
}

check_emails_bulk

Validate multiple emails at once (up to 100).

Input:

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}

Output:

{
  "results": [
    {
      "email": "[email protected]",
      "isTemporary": false,
      "domain": "gmail.com",
      "risk": "low"
    },
    {
      "email": "[email protected]",
      "isTemporary": true,
      "domain": "tempmail.com",
      "provider": "TempMail",
      "risk": "high"
    },
    {
      "email": "[email protected]",
      "isTemporary": true,
      "domain": "10minutemail.com",
      "provider": "10MinuteMail",
      "risk": "high"
    }
  ],
  "summary": {
    "total": 3,
    "temporary": 2,
    "legitimate": 1
  }
}

💡 Usage Examples

With Claude Desktop

"Check if [email protected] is a temporary email"

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

"I have a list of 50 emails from a signup form. Can you check which ones are temporary?"

With Cline

Ask Cline to validate emails while coding:

"Before processing this user registration, check if their email is temporary"

"Add email validation to this signup endpoint using the antitempmail tool"

🔧 Development

Build from Source

git clone https://github.com/EricMymj/antitempmail-mcp.git
cd antitempmail-mcp
npm install
npm run build

Run Locally

export ANTITEMPMAIL_API_KEY="your_api_key_here"
node dist/index.js

Test with MCP Inspector

npx @modelcontextprotocol/inspector antitempmail-mcp

📊 API Limits

| Tier | Requests/Day | Price | |------|--------------|-------| | Free | 100 | $0 | | Pro | 10,000 | $9/mo | | Enterprise | Custom | Contact |

Check your usage at: https://antitempmail.com/dashboard/credits

🤝 Contributing

Contributions welcome! Please open an issue or PR.

📄 License

MIT License - see LICENSE for details.

🔗 Links

• AntiTempMail Website
• API Documentation
• MCP Documentation
• Report Issues

🆘 Troubleshooting

"ANTITEMPMAIL_API_KEY environment variable is required"

Make sure you've added your API key to the MCP server configuration. Get your key from https://antitempmail.com/dashboard

"API error (401): Unauthorized"

Your API key is invalid or expired. Generate a new one from the dashboard.

"API error (429): Too Many Requests"

You've exceeded your rate limit. Upgrade your plan or wait for the limit to reset.

Server not showing in Claude Desktop

1. Restart Claude Desktop completely
2. Check the config file syntax (must be valid JSON)
3. Verify the command path is correct
4. Check Claude Desktop logs for errors