# ZeroBounce MCP

> ZeroBounce validates email addresses in real time or on bulk lists. This MCP checks if an email is active, disposable, or invalid, drastically improving your campaign deliverability rates. It also scores entire files to help you focus only on the highest-value leads.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** email-validation, deliverability, list-cleaning, email-verification, bounce-prevention

## Description

Don't send emails to dead accounts. ZeroBounce helps marketing teams clean up their contact lists before running big campaigns. You can check a single email address instantly or validate hundreds at once, protecting your sender reputation from bounces and spam traps.

The MCP lets you dig deep into list quality. Need to know if an account was active last month? You can retrieve historical activity data for any address. If you're building complex automation that runs through several platforms—say, pulling leads from a CRM, sending them a message via a communication tool, and then logging the outcome in a billing system—you can chain ZeroBounce with those other MCPs. This means your entire workflow is managed by one agent, all running securely within Vinkius, which provides full visibility into every step taken, letting you track exactly what data flowed through.

Furthermore, if you're scoring leads based on multiple criteria, the platform uses native token optimization to cut down on processing costs while giving you a quality score for your entire list. This guarantees that only high-value contacts are passed down the line. You simply connect it to your preferred AI client and start sending out clean campaigns.

## Tools

### get_activity
Checks a specific email address's usage data to determine if it has been active within certain timeframes.

### get_credits
Retrieves your current remaining credit balance for the ZeroBounce service.

### score_file
Generates a quality score, from 0 to 100, for an entire file containing many emails.

### validate_batch
Runs validation checks on a group of up to 100 email addresses simultaneously.

### validate_email
Performs a quick, deep check on one individual email address's validity and risk level.

## Prompt Examples

**Prompt:** 
```
Check my remaining ZeroBounce credits.
```

**Response:** 
```
You currently have 12,450 credits remaining in your ZeroBounce account.
```

**Prompt:** 
```
Validate the email address 'john.doe@example.com'.
```

**Response:** 
```
The email 'john.doe@example.com' is valid. It is not a disposable address and has a low risk score.
```

**Prompt:** 
```
Check if 'marketing@business.com' has been active in the last 90 days.
```

**Response:** 
```
I've checked the activity data. The email 'marketing@business.com' has been active within the last 90 days.
```

## Capabilities

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### Preparing for a major product launch campaign
The marketing lead needs to ensure zero bounce rates. They ask their agent to run `validate_batch` on the entire mailing list, followed by using `score_file` to filter out anything below an 80 score before sending it through the email platform.

### Building a multi-stage sales sequence
An SDR uses their agent to first check if a lead's contact is valid using `validate_email`. If the address passes, they then ask the agent to run `get_activity` to confirm the account was active in the last 60 days before sending the outreach message.

### Debugging low campaign performance
The ops team notices a high bounce rate. They connect their data source and ask the agent to run `get_credits` first, then use `score_file` on the last month's list to identify if poor list quality was the root cause.

### Onboarding new contacts into a system
The developer integrates ZeroBounce into the signup flow. When a user submits an email, the agent immediately calls `validate_email` before creating the record in the database, preventing fake accounts entirely.

## Benefits

- Stop sending emails to throwaway or invalid addresses. Use `validate_email` for immediate checks on single leads during prospecting calls.
- Save time scrubbing huge lists. Run a full batch validation using `validate_batch` to process up to 100 contacts in one call, instead of doing it manually.
- Identify your best targets first. The `score_file` tool gives you a quality rating for every email address, letting you focus only on high-potential leads (the 90+ score group).
- Maintain service uptime by checking your account status with the `get_credits` tool before running large campaigns.
- Determine lead engagement. Run `get_activity` to see if an email has been active in the last year, ensuring you're targeting people who actually use their inbox.

## How It Works

The bottom line is you get confidence that the emails leaving your system are actually going to someone who uses them.

1. First, you subscribe to the MCP and input your ZeroBounce API Key into your preferred AI client.
2. Next, instruct your agent to perform an action—for example, asking it to validate a list of contacts or check the activity for specific addresses.
3. The platform returns structured data showing the status (valid/invalid), quality score, or historical usage details.

## Frequently Asked Questions

**How do I check my available credits using the ZeroBounce MCP?**
Use `get_credits`. This tool instantly reports your remaining account balance, which is crucial for planning large-scale campaigns and preventing unexpected service interruptions.

**Can I validate a list of 100 emails at once with ZeroBounce MCP?**
Yes, use `validate_batch`. This tool allows you to submit up to 100 addresses in one request. It's much more efficient than validating them individually using `validate_email`.

**What is the best way to confirm lead activity with ZeroBounce MCP?**
Use `get_activity`. This tool lets you check if an email address has been active within a specific time range, ensuring your outreach targets people who are actually engaged.

**Does the ZeroBounce MCP only validate current emails?**
No. In addition to real-time checks like `validate_email`, you can run `score_file` on bulk data, which provides a deeper analysis of overall list quality.

**What does the AI Scoring result from the `score_file` tool actually mean?**
The score is a quality metric from 0-100. High scores indicate active, deliverable addresses ready for campaigns. If you get a low score, it suggests potential issues with the email that require manual review.

**If I run `validate_email` and receive an error code, how do I troubleshoot it?**
The tool response specifies why validation failed. It tells you if the address is malformed, a catch-all, or known spam data, giving you exact details to fix your source list.

**Are there rate limits when I use `validate_batch`? How do I handle high volume?**
Vinkius manages the call flow. While there are API usage rates, your agent controls the speed by pausing between requests if needed. This prevents hitting service-side throttling limits.

**Can `score_file` process emails from any type of domain?**
Yes. The system doesn't restrict validation based on the domain source. It checks every address against its global database to verify if it's structurally valid and active.

**How can I check how many credits I have left in my ZeroBounce account?**
You can use the `get_credits` tool. It will return the exact number of remaining credits available for validation and scoring in your account.

**Is it possible to check if an email address has been active recently?**
Yes, use the `get_activity` tool. It checks if the email address has shown activity in the last 30, 60, 90, 180, or 365 days, helping you identify engaged users.

**Can I validate multiple emails at once?**
Yes! The `validate_batch` tool allows you to submit an array of up to 100 email addresses in a single request for rapid verification.