# NeverBounce MCP

> NeverBounce connects to your AI client to clean up and verify large lists of emails. Check single addresses for immediate status (valid, disposable, etc.) or run massive bulk jobs from uploaded CSV files or remote URLs. It gives you confidence that the email addresses in your database actually exist and are ready for campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** email-verification, list-cleaning, data-quality, deliverability, bulk-processing

## Description

Need to know if those prospect emails are even real? This MCP lets your agent check any email address instantly, giving you its current status—valid, invalid, disposable, or something else. If you've got a huge list of contacts that need cleaning, you don't have to paste them one by one. Instead, the agent can create and manage bulk jobs from raw data inputs or even remote CSV links. You monitor these large batches as they run and fetch all the results once they finish. This whole process runs right inside your chat interface, making sure your marketing campaigns only hit addresses that actually work. Connecting this MCP through Vinkius means you get access to robust email validation without leaving your preferred AI client.

## Tools

### check_email
Verifies the deliverability status of one specific email address.

### create_job_from_input
Starts a bulk job using raw text or arrays of emails you provide directly in the chat.

### create_job_from_url
Creates and starts a large verification job by reading email addresses from a remote CSV URL.

### delete_job
Removes an existing bulk job record to keep your history clean.

### get_account_info
Checks your remaining credit balance and provides general account details for tracking usage.

### get_job_results
Fetches the final, verified results file for a bulk job once it has finished processing.

### get_job_status
Checks the current progress (e.g., 50% complete) and status of any active batch job.

### list_jobs
Lists all historical bulk verification jobs associated with your account ID.

### parse_job
Starts the process of parsing or preparing a specific, existing job for further action.

### start_job
Initiates a bulk verification batch job using parameters you define.

## Prompt Examples

**Prompt:** 
```
Verify if the email 'test@example.com' is valid.
```

**Response:** 
```
Checking email... The result for 'test@example.com' is VALID. No deliverability issues were found and no flags were raised. Shall I check your remaining credits?
```

**Prompt:** 
```
List all my recent verification jobs.
```

**Response:** 
```
Retrieving your jobs... I found 3 recent jobs: 'Lead List Q1' (Status: Completed), 'Prospects March' (Status: Running), and 'Web Signups' (Status: Parsing). Would you like the results for 'Lead List Q1'?
```

**Prompt:** 
```
Check the status of job ID 123456.
```

**Response:** 
```
Inspecting job 123456... This job is currently 75% complete. Out of 1,000 emails, 600 have been verified as Valid and 150 as Invalid so far. I'll let you know when it reaches 100%.
```

## Capabilities

### Verify single emails
The agent checks an individual email address and returns its deliverability status.

### Run bulk verification jobs from raw data
You send a list of emails directly to the MCP, which then starts processing them in batches.

### Process lists from URLs
The agent reads email addresses from a remote CSV file and initiates a bulk cleaning job.

### Monitor job progress
You track the status of any running verification batch, seeing how many emails are processed so far.

### Retrieve completed results
Once a bulk job is done, you fetch all the verified results for review or download.

## Use Cases

### Lead List Cleanup Before Campaign Launch
A Marketing Manager has downloaded a massive list of leads from an event. Instead of spending hours running the list through external tools, they ask their agent to use `create_job_from_url` on the CSV file. The MCP processes all 5,000 emails and returns only the validated results for immediate import into the CRM.

### Validating a Critical Contact
A Sales Development Rep finds a key contact's email in an old document. They ask their agent to use `check_email` immediately, confirming if it’s active and deliverable before pitching the account.

### Auditing Data Source Quality
A Data Analyst needs to audit which data sources are most reliable. They list all recent jobs using `list_jobs`, checking the status of past verification efforts across multiple departments for compliance review.

### Managing Large Project Batches
The development team uploads a huge dataset to test its integrity. They use `start_job` and then periodically check progress with `get_job_status`, ensuring the job completes successfully without manual monitoring.

## Benefits

- Stop sending emails to dead addresses. Use the `check_email` tool to instantly confirm if a single lead's email is valid before you even add them to a campaign.
- Process thousands of contacts without friction. You can create and start bulk jobs using `create_job_from_url`, letting your agent read lists directly from remote CSV files.
- Never wonder what happened to a job again. The `get_job_status` tool gives you real-time visibility into running batches, so you know exactly when the cleanup is done.
- Keep track of usage and billing. Check your account credits using `get_account_info` anytime to manage costs right from the chat window.
- Handle complex workflows easily. Instead of manually downloading results, use `get_job_results` to pull all verified data into your current conversation for immediate analysis.

## How It Works

The bottom line is that your AI client handles all the complexity of running massive data cleanup tasks using simple conversation prompts.

1. First, connect your NeverBounce API key to this MCP in Vinkius.
2. Next, ask your AI agent what needs cleaning—is it a single email check or are you feeding it a list from a URL?
3. Finally, the agent executes the job and shows you the status, letting you retrieve all results when the verification is complete.

## Frequently Asked Questions

**How do I check if just one email address is valid using NeverBounce MCP?**
You use the `check_email` tool. Simply ask your agent to verify the specific email, and it will return its current status (valid, disposable, etc.) right away.

**Can I clean a list of emails from a website URL?**
Yes, use `create_job_from_url`. You just need to provide the remote CSV link, and the MCP handles reading the data and starting the bulk verification job.

**What do I do if my large batch job fails or gets stuck?**
Check the status with `get_job_status`. This will tell you where the job stopped. If it was a temporary issue, you can try to restart it using `start_job`.

**Is there a way to see all my past email verification runs?**
Absolutely. Use the `list_jobs` tool. It provides an overview of every job you've run, including dates and status, helping with auditing.

**How do I get the actual results after a bulk job is done?**
Once the job status shows 'Completed', use `get_job_results`. This fetches all the verified emails into one consolidated set for you to download or analyze.