ZeroBounce MCP Server

Name: ZeroBounce MCP Server
Author: avivshafir

@avivshafir

Repository

About ZeroBounce MCP Server

zerobounce-mcp-server

#zerobounce #email-validation #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ZeroBounce MCP Server?

A Model Context Protocol (MCP) server that integrates with the ZeroBounce email validation service using the official ZeroBounce Python API v2. It allows AI assistants like Cursor to validate emails, check credits, manage bulk validation files, and search domain email patterns.

How to use ZeroBounce MCP Server?

Install Python 3.10+, clone the repository, install dependencies with pip install -r requirements.txt, set your ZEROBOUNCE_API_KEY environment variable (via .env file or export), and add the server configuration to your mcp.json file pointing to main.py. Restart Cursor to use the tools within the AI assistant.

Key features of ZeroBounce MCP Server

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

Use cases of ZeroBounce MCP Server

Validate a single email address in an AI chat
Monitor remaining credits before bulk operations
Upload a CSV of emails for batch validation
Retrieve and delete completed bulk validation results
Discover email naming conventions for a domain

FAQ from ZeroBounce MCP Server

What does this server do?

It provides MCP tools to interact with ZeroBounce’s email validation API, allowing AI assistants to validate emails, check credits, manage bulk files, and search domain patterns.

What are the runtime requirements?

Python 3.10 or higher and a valid ZeroBounce API key are required. Dependencies include zerobounce-python-api-v2, python-dotenv, and mcp.

How do I get a ZeroBounce API key?

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

Which tools does the server expose?

Seven tools: validate_email, get_credits, upload_file, check_file_status, get_file, delete_file, and domain_search.

How is the server configured for use?

Add a JSON block to your mcp.json file specifying python as the command and the full path to main.py as the argument. Set the ZEROBOUNCE_API_KEY environment variable.