Skip to main content
ZeroBounce Docs logo
Log InSign Up Free
  • Home
  • Getting started
  • Products
  • API
  • Integrations
  • FAQ
  • About ZeroBounce
Browse documentation
ZeroBounce Docs logo
  • Getting started
  • Products
  • API
  • Integrations
  • FAQ
  • About ZeroBounce

Type at least 2 characters to search the docs.

↑↓ Navigate↵ OpenEsc Close

Docs Assistant

Answers written from the ZeroBounce documentation

Hi! I'm your ZeroBounce Docs Assistant. How can I help you with our APIs or integrations today?

Try Asking

Loading suggestions...

AI-generated from our docs. Check important details against the linked pages.

Integrations

  • ActiveCampaign Integration
  • Adobe Journey Integration
  • Adobe Marketo Integration
  • Amazon S3 Integration
  • Amazon S3 Bulk API
  • BigCommerce Integration
  • AWeber Integration
  • Clay.com Integration
  • Drip Integration
  • Customer.io Integration
  • Constant Contact Integration
  • Contact Form 7 Integration
  • Email Validator Browser Extension
  • Ghost Integration
  • CloudFlare Worker Integration
  • ChatGPT Integration
  • Claude
  • Google Sheets Integration
  • Gravity Forms Integration
  • Infinity Integration
  • Integrations Contacts Monitoring, Scheduling and Sharing
  • iPost Integration
  • HubSpot Integration
  • Iterable Integration
  • HubSpot Forms Integration
  • HubSpot Warmup Integration
  • JS Widget
  • Klaviyo Integration
  • Klaviyo Forms Integration
  • LinkedIn Integration
  • Mailchimp Integration
  • Microsoft Dynamics Integration
  • MailerLite Integration
  • monday.com Integration
  • Moosend Integration
  • Outreach Integration
  • PipeDrive Integration
  • Salesforce Integration v1.39
  • SFTP/FTP Integration
  • SFTP/FTP Bulk API
  • Unbounce Integration
  • Wix Integration
  • WordPress/WooCommerce Plugins
  • Zapier Integration
  • Zendesk Sell Integration
  • ZeroBounce MCP Server
    • Setup
    • Tools
  • Zoho Integration
  1. Home
  2. API Integrations
  3. Zerobounce MCP Server

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:

Validation Tools

  • Tool
    Description
  • validate_email
    Validate a single email address using ZeroBounce API. Returns detailed validation results including status, sub-status, and additional metadata.
  • validate_batch
    Validate multiple email addresses in batch. More efficient for validating multiple emails at once.

Account Tools

  • Tool
    Description
  • get_credits
    Get the number of credits remaining in your ZeroBounce account.
  • get_api_usage
    Get API usage statistics for a date range. Shows validation counts by status and sub-status.

Bulk Validation File Tools

  • Tool
    Description
  • bulk_validate_send_file
    Send a CSV file for bulk email validation. Returns a file ID for tracking.
  • bulk_validate_file_status
    Get the status of a bulk validation file upload.
  • bulk_validate_get_file
    Get the results of a completed bulk validation file.
  • bulk_validate_delete_file
    Delete a bulk validation file from your account.

AI Scoring Tools

  • Tool
    Description
  • bulk_ai_scoring_send_file
    Send a CSV file for bulk AI email scoring. Returns a file ID for tracking.
  • bulk_ai_scoring_file_status
    Get the status of a bulk AI scoring file upload.
  • bulk_ai_scoring_get_file
    Get the results of a completed bulk AI scoring file.
  • bulk_ai_scoring_delete_file
    Delete a bulk AI scoring file from your account.

Email Finder Tools

  • Tool
    Description
  • find_email
    Find an email address based on domain, name, and/or company.
pinned

Note:

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

Domain Search Tools

  • Tool
    Description
  • domain_search
    Search for email addresses in a domain.
pinned

Note:

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

Activity Data Tools

  • Tool
    Description
  • get_activity_data
    Get activity data for an email address to see if it has been active recently.

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
    Cause
    Solution
  • Missing API key
    API key not provided
    Add --api-key argument
  • Invalid API key
    API key is incorrect or expired
    Verify your API key in the ZeroBounce dashboard
  • Network errors
    Cannot connect to ZeroBounce API
    Check your internet connection and firewall settings
  • Rate limiting
    Too many requests
    Wait and retry, or upgrade your ZeroBounce plan
  • Invalid email format
    Email address format is invalid
    Check the email address format
  • Invalid date format
    Date not in YYYY-MM-DD format
    Use the correct date format (e.g., "2024-01-31")
  • Insufficient credits
    Not enough credits in account
    Add credits to your ZeroBounce account
  • File not found
    Bulk validation file ID is invalid
    Verify the file ID from the upload response

Error Response Format

Errors are returned in a structured format:

Was this page helpful?

PreviousZendesk Sell IntegrationNextCursor
Interested in our partner programs?
Partner program

Interested in our partner programs?