npm package: @orristech/antitempmail-mcp
Description: MCP server for temporary email validation using AntiTempMail API
Author: AntiTempMail
Latest version: 1.0.0

# AntiTempMail MCP Server

[![MCP](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)
[![npm](https://img.shields.io/npm/v/@antitempmail/mcp-server)](https://www.npmjs.com/package/@antitempmail/mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Model Context Protocol (MCP) server for validating email addresses against temporary/disposable email providers using the [AntiTempMail](https://antitempmail.com) API.

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

## 🚀 Quick Start

### Installation

```bash
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`

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

#### Cline (VS Code Extension)

Add to Cline's MCP settings:

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

### Get Your API Key

Sign up at [AntiTempMail](https://antitempmail.com) and get your API key from the [Dashboard](https://antitempmail.com/dashboard).

## 🛠️ Available Tools

### `check_email`

Validate a single email address.

**Input:**
```json
{
  "email": "test@tempmail.com"
}
```

**Output:**
```json
{
  "email": "test@tempmail.com",
  "isTemporary": true,
  "domain": "tempmail.com",
  "provider": "TempMail",
  "risk": "high",
  "confidence": 98
}
```

### `check_emails_bulk`

Validate multiple emails at once (up to 100).

**Input:**
```json
{
  "emails": [
    "user1@gmail.com",
    "user2@tempmail.com",
    "user3@10minutemail.com"
  ]
}
```

**Output:**
```json
{
  "results": [
    {
      "email": "user1@gmail.com",
      "isTemporary": false,
      "domain": "gmail.com",
      "risk": "low"
    },
    {
      "email": "user2@tempmail.com",
      "isTemporary": true,
      "domain": "tempmail.com",
      "provider": "TempMail",
      "risk": "high"
    },
    {
      "email": "user3@10minutemail.com",
      "isTemporary": true,
      "domain": "10minutemail.com",
      "provider": "10MinuteMail",
      "risk": "high"
    }
  ],
  "summary": {
    "total": 3,
    "temporary": 2,
    "legitimate": 1
  }
}
```

## 💡 Usage Examples

### With Claude Desktop

> "Check if test@tempmail.com is a temporary email"

> "Validate these emails: user1@gmail.com, user2@10minutemail.com, user3@yahoo.com"

> "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

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

### Run Locally

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

### Test with MCP Inspector

```bash
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](LICENSE) for details.

## 🔗 Links

- [AntiTempMail Website](https://antitempmail.com)
- [API Documentation](https://antitempmail.com/docs)
- [MCP Documentation](https://modelcontextprotocol.io)
- [Report Issues](https://github.com/EricMymj/antitempmail-mcp/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