home / mcp / zerobounce mcp server

ZeroBounce MCP Server

zerobounce-mcp-server

Installation

Add the following to your MCP client configuration file.

Configuration

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

You set up an MCP server that enables you to interact with ZeroBounce for single email validation, credits checks, and bulk validation tasks. This server exposes practical tools you can call from your MCP client to validate emails, monitor usage, and manage bulk files efficiently.

How to use

You will run the ZeroBounce MCP Server locally and connect to it via your MCP client. Use the provided tools to validate a single email, check remaining credits, upload files for bulk validation, monitor file processing, and search for domain email patterns. Each tool returns structured results that you can inspect and use in your workflows.

How to install

# prerequisites
Python 3.10+

# 1) clone the MCP server
git clone https://github.com/avivshafir/zerobounce-mcp-server
cd zerobounce-mcp-server

# 2) install dependencies
pip install -r requirements.txt

# 3) configure API key
# Option 1: create a .env file in the project root
# ZEROBOUNCE_API_KEY=your_zerobounce_api_key

# Option 2: export it in your shell
export ZEROBOUNCE_API_KEY="your_zerobounce_api_key"

# 4) configure the MCP entry point
# Add the following to mcp.json, replacing the path with your actual location
{
  "mcpServers": {
    "zerobounce": {
      "command": "python",
      "args": ["/path/to/your/zerobounce-mcp-server/main.py"]
    }
  }
}

# 5) start the server (as configured above in your environment)
# Use your MCP client to connect according to its workflow

Configuration and environment

The server requires your ZeroBounce API key for authentication. You can provide it via a .env file or as a shell environment variable. The following environment variable is used by the server:

ZEROBOUNCE_API_KEY=your_zerobounce_api_key

Server configuration snippet

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

Available tools

validate_email

Validate a single email address via the ZeroBounce service and return validation results.

get_credits

Query the remaining credits on your ZeroBounce account to monitor usage.

upload_file

Upload a file for bulk validation and initiate processing of emails in that file.

check_file_status

Check the processing status of a previously uploaded bulk file.

get_file

Retrieve the results for a previously uploaded bulk validation file.

delete_file

Remove a bulk validation file from the server storage.

domain_search

Search for email patterns used by a specific domain.