ZeroBounce MCP Server

A comprehensive Model Context Protocol (MCP) server that provides full-featured email validation, verification, and intelligence capabilities through ZeroBounce's API. This server enables AI coding assistants and MCP-compatible clients to validate email addresses, find emails, score email quality, search domains, and much more.

https://github.com/zerobounce/zerobounce-mcp

Features

Core Capabilities

Email Validation: Validate single or multiple email addresses with detailed results

Batch Processing: Efficiently process large volumes of emails via CSV upload

AI Scoring: Evaluate email quality and deliverability using AI via bulk CSV file uploads

Email Finderⓘ: Find email addresses based on name and company/domain

Domain Search: Search for all email addresses in a domain

Activity Data: Check if an email address has been recently active

Credit Management: Monitor remaining credits in your ZeroBounce account

Usage Analytics: Get detailed API usage reports for any date range

Key Benefits

🚀 Fast Integration: Quick setup with MCP-compatible clients

🔒 Secure: API key management with environment variable support

📊 Broad Coverage: Access to all major ZeroBounce API endpoints exposed by the official Node SDK and suitable for MCP tools

🎯 Accurate: Industry-leading email validationⓘ accuracy

🔄 Real-time: Instant validation and scoring results

Quick Start

Install the MCP server globally

npm install -g @zerobounce/mcp

This will install the zerobounce-mcp command globally.

Get your ZeroBounce API key from the ZeroBounce Dashboard

Add to your MCP client (Cursor, VS Code, Claude Desktop, etc.):

Start using it in your AI assistant:

Getting Your API Key

Your ZeroBounce API key is available in the ZeroBounce dashboard:

Sign in to your ZeroBounce account

Navigate to the API / Developer or Integrations section

Create or copy an API key for this integration

Use different keys for development, staging, and production when possible

Note: Treat your API key like a password. Do not share it or commit it to version control.

MCP Client Configuration

Most MCP-compatible clients use the same basic configuration shape. A minimal example looks like:

Tools

The ZeroBounce MCP server provides the following tools, organized by category:

Note: Bulk Email Finder file operations are not available via the official Node SDK and are not exposed as MCP tools.

Note: Bulk Domain Search file operations are not available via the official Node SDK and are not exposed as MCP tools.

Limitations and Non-Supported Endpoints

• Custom filters / filter management: Not available via the official ZeroBounce Node SDK and therefore not exposed as MCP tools.
• List Evaluator: The List Evaluator endpoint is not supported by the Node SDK and is not implemented in this MCP server.
• Per-email AI scoring tool: AI scoring is currently supported only via bulk CSV file operations, not as a single-email scoring tool.

Resources

The server provides the following resources:

zerobounce://config — Current ZeroBounce API configuration (base URL and whether API key is configured).

Usage Examples

Basic Email Validation

Validate a single email:

Validate the email address "test@example.com"

Validate with IP address for better accuracy:

Validate "test@example.com" from IP address "192.168.1.1"

Validate multiple emails in batch:

Check if these emails are valid: ["user1@example.com", "user2@example.com", "user3@example.com"]

Account Management

Check remaining credits:

How many credits do I have left in my ZeroBounce account?

Get usage statistics:

Show me my ZeroBounce API usage for January 2024

Show usage from specific dates:

Get my API usage from 2024-01-01 to 2024-01-31

AI Email Scoring

Score emails via CSV upload:

Use AI to score the quality and deliverability of these email addresses and return the results as a CSV: [paste CSV content]

Email Finding

Find an email by name and domain:

Find the email for John Doe at example.com

Find email by name and company:

Find the email for John Doe at Example Corp (example.com)

Domain Search

Search for emails in a domain:

Search for all email addresses at example.com

Search with filters:

Find emails for people named John at example.com

Activity Data

Check email activity:

Check if test@example.com has been active recently

Bulk Operations

Upload a file for bulk validation:

Bulk validate the emails in this CSV file: [paste CSV content]

Check bulk validation status:

Check the status of my bulk validation file abc123

Get bulk validation results:

Get the results for my completed bulk validation file abc123

Error Handling

The server handles errors gracefully and returns descriptive error messages:

Common Errors

Error Response Format

Errors are returned in a structured format: