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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that allows interaction with the ZeroBounce email validation service, enabling users to validate individual emails, check account credits, and perform bulk validations.

Related MCP Servers

ClaudePost
ZilongXue
A
security
A
license
A
quality
A Model Context Protocol server that provides a seamless email management interface through Claude, allowing users to search, read, and send emails directly through natural language conversations.
Last updated -
4
95
Python
MIT License
MCP-Email-Verify
Abhi5h3k
A
security
F
license
A
quality
A lightweight Model Context Protocol (MCP) server that enables your LLM to validate email addresses. This tool checks email format, domain validity, and deliverability using the AbstractAPI Email Validation API. Perfect for integrating email validation into AI applications like Claude Desktop.
Last updated -
1
2
Python
NeverBounce MCP Server
Meerkats-Ai
-
security
F
license
-
quality
A Model Context Protocol server that integrates with NeverBounce API to validate email addresses, checking if they are valid, deliverable, and safe to send to.
Last updated -
JavaScript
Enrichment MCP Server
MSAdministrator
A
security
F
license
A
quality
A Model Context Protocol server that enables users to perform third-party enrichment lookups for security observables (IP addresses, domains, URLs, emails) through services like VirusTotal, Shodan, and others.
Last updated -
1
1
Python

View all related MCP servers