zerobounce-mcp-server by avivshafir - MCP Server

ZeroBounce MCP Server

This is a Model Context Protocol (MCP) server for interacting with the ZeroBounce email validation service. It uses the official ZeroBounce Python API v2 library.

Features

Validate individual email addresses
Check your remaining API credits
Upload files for bulk validation
Check file status, retrieve, and delete bulk validation files
Search for email patterns used by a domain

Setup

System Requirements

Python 3.10+
API key from ZeroBounce

Installation

Clone this repository:

git clone https://github.com/avivshafir/zerobounce-mcp-server
cd zerobounce-mcp-server

Install the required dependencies:

pip install -r requirements.txt

Set up your environment variables:

Option 1: Using a .env file (recommended)

Create a .env file with your ZeroBounce API key:
```
ZEROBOUNCE_API_KEY=your_zerobounce_api_key
```
Option 2: Setting environment variables directly
```
export ZEROBOUNCE_API_KEY="your_zerobounce_api_key"
```

You can get your API key from your ZeroBounce account dashboard.

Add the following configuration to the mcp.json file, replacing the directory path with the actual path to where you've installed this server:

{
  "mcpServers": {
    "zerobounce": {
      "command": "python",
      "args": ["/path/to/your/zerobounce-mcp-server/main.py"]
    }
  }
}

Restart Cursor to apply the changes

Now you can use the ZeroBounce MCP server directly within Cursor's AI assistant.

Available Tools

The server provides the following tools:

validate_email: Validate a single email address

validate_email(email: str, ip_address: str = "") -> dict

get_credits: Check remaining credits in your ZeroBounce account
```
get_credits() -> dict
```

upload_file: Upload a file for bulk validation

upload_file(file_path: str, email_column: int, ...) -> dict

check_file_status: Check the status of a bulk validation file
```
check_file_status(file_id: str) -> dict
```
get_file: Get the results of a bulk validation
```
get_file(file_id: str) -> dict
```
delete_file: Delete a bulk validation file
```
delete_file(file_id: str) -> dict
```
domain_search: Search for email patterns used by a domain
```
domain_search(domain: str) -> dict
```

Dependencies

zerobounce-python-api-v2: The official ZeroBounce API library
python-dotenv: For loading environment variables from .env file
mcp: The Model Context Protocol library
asyncio: For asynchronous operations