Atdata Email Verification MCP Server

🚀 AtData SafeToSend MCP Server

A Model Context Protocol (MCP) server that uses AtData's SafeToSend API to offer email verification services. It helps you verify email addresses, filter out invalid and high - risk ones, and achieve higher open rates, clicks, and conversions.

AtData SafeToSend API Documentation

✨ Features

• Email Verification: Use AtData's SafeToSend API to verify individual email addresses.
• Batch Verification: Verify multiple email addresses at once and get summary statistics.
• Comprehensive Error Handling: Receive detailed error messages for different failure scenarios.
• Environment Variable Support: Securely manage your API key through environment variables.
• Rate Limiting Awareness: Handle API rate limits properly.

📦 Installation

1. Clone this repository:

git clone <repository-url>
cd atdata-mcp-server

2. Install dependencies using uv (recommended) or pip:

# Using uv
uv sync

# Using pip
uv pip install .

🚀 Quick Start

Get AtData API Key

1. Sign up for an AtData account at https://atdata.com.
2. Obtain your API key from the AtData dashboard.
3. Set up your API key as an environment variable:

export ATDATA_API_KEY="your-api-key-here"

Or create a .env file in the project root:

ATDATA_API_KEY=your-api-key-here

Running the Server

Method 1: Direct Python execution

python server.py

Method 2: Using FastMCP CLI

fastmcp run server.py

Method 3: Install for Claude Desktop

fastmcp install server.py

Using with uv

If you're using uv, you can also run the server with:

{
  "mcpServers": {
    "atdata-email-verification-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/your/atdata-email-verification-mcp-server",
      "env": {
        "ATDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 Usage Examples

Available Tools

1. verify_email

Verify a single email address.

Parameters:

• email (string, required): The email address to verify.
• api_key (string, optional): AtData API key (uses environment variable if not provided).

Example:

{
    "email": "user@example.com",
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

Response:

{
    "success": True,
    "email": "user@example.com",
    "verification_result": {
        "email": "user@example.com",
        "status": "valid",
        "deliverable": True,
        "risk_level": "low",
        # Additional verification details from AtData API
    }
}

2. batch_verify_emails

Verify multiple email addresses in batch.

Parameters:

• emails (array of strings, required): List of email addresses to verify.
• api_key (string, optional): AtData API key (uses environment variable if not provided).

Example:

{
    "emails": ["user1@example.com", "user2@domain.com", "invalid@email"],
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

Response:

{
    "results": [
        {
            "success": True,
            "email": "user1@example.com",
            "verification_result": { /* verification details */ }
        },
        {
            "success": True,
            "email": "user2@domain.com", 
            "verification_result": { /* verification details */ }
        },
        {
            "error": "Bad request. Please check the email format.",
            "email": "invalid@email",
            "status_code": 400
        }
    ],
    "summary": {
        "total": 3,
        "successful": 2,
        "failed": 1,
        "success_rate": 66.67
    }
}

🔧 Technical Details

Error Handling

The server provides comprehensive error handling for various scenarios:

• Missing API Key: Returns an error when no API key is provided.
• Authentication Errors: Handles invalid API keys (401 status).
• Bad Requests: Handles invalid email formats (400 status).
• Rate Limiting: Handles API rate limit exceeded (429 status).
• Network Issues: Handles connection errors and timeouts.
• Unexpected Errors: Catches and reports any unexpected exceptions.

📚 Documentation

This server is based on the AtData SafeToSend API. For more details about the underlying API, see:

• AtData SafeToSend API Documentation

Development

Project Structure

atdata-mcp-server/
├── src/
│   └── server.py          # Main MCP server implementation
├── pyproject.toml         # Project configuration and dependencies
├── uv.lock               # Locked dependencies
└── README.md             # This file

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Make your changes.
4. Add tests if applicable.
5. Submit a pull request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

For issues related to:

• This MCP Server: Open an issue in this repository.
• AtData API: Contact AtData support or check their documentation.
• FastMCP Framework: Check the FastMCP documentation