Docs
Docs
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
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
🚀 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
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:
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.
Most MCP-compatible clients use the same basic configuration shape. A minimal example looks like:
The ZeroBounce MCP server provides the following tools, organized by category:
Validation Tools
Account Tools
Bulk Validation File Tools
AI Scoring Tools
Email Finder Tools
Domain Search Tools
Activity Data Tools
The server provides the following resources:
zerobounce://config — Current ZeroBounce API configuration (base URL and whether API key is configured).
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"]
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
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]
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)
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
Check email activity:
Check if test@example.com has been active recently
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
The server handles errors gracefully and returns descriptive error messages:
Common Errors
Errors are returned in a structured format:
