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

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
-
security
A
license
-
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 -
40
Python
MIT License
NPM Sentinel MCP
Nekzus
A
security
A
license
A
quality
A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
Last updated -
19
464
2
TypeScript
MIT License
Google Workspace MCP Server
rishipradeep-think41
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Gmail and Calendar APIs, enabling programmatic management of emails and calendar events.
Last updated -
8
7
JavaScript
MIT License
MCP-Email-Verify
Abhi5h3k
-
security
F
license
-
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
Python

View all related MCP servers

ZeroBounce MCP Server