# EmailListVerify MCP

> EmailListVerify lets your AI agent check email deliverability and clean up massive lists instantly. It handles single-address checks, manages entire bulk verification jobs, tracks job status, and monitors your credit balance in real time. Don't send emails to dead addresses; let your agent do the dirty work so you can focus on writing good copy.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** email-validation, deliverability, data-cleaning, bulk-processing, spam-prevention, list-hygiene

## Description

Need to know if that list of contacts is actually worth emailing? This MCP connects a powerful bulk email verification system directly into your AI workflow. Instead of manually running checks or dealing with flaky spreadsheets, your agent handles all the deliverability analysis through simple conversation.

It verifies individual emails against MX records and SMTP connection checks. For bigger projects, you can upload files for bulk jobs and monitor their status without ever leaving your chat window. You also keep tabs on organizational quotas and credit usage right there in the thread. When you connect this MCP to Vinkius, your agent becomes a full-time list hygiene specialist, giving you clean data ready for any marketing campaign.

## Tools

### get_emaillistverify_metadata
Pulls general account settings and metadata details for your EmailListVerify setup.

### get_remaining_credits
Tells you exactly how many verification credits are left in your account.

### get_verification_job_status
Provides the current status and summary results for a specific bulk job file.

### quick_verification_health_audit
Generates a quick, high-level report on your verification activity and overall success rates.

### list_successfully_processed_files
Identifies all the bulk verification files that finished processing completely.

### list_in_progress_verification_jobs
Lists any bulk jobs currently waiting in or running through the processing queue.

### list_latest_verification_jobs
Shows the most recently uploaded email verification files, regardless of status.

### list_verification_jobs
Provides a comprehensive list of every bulk email verification job in your account history.

### verify_single_email
Performs a full deliverability check on a single provided email address.

## Prompt Examples

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

**Response:** 
```
I've verified 'test@example.com'. The status is 'ok' (Valid). It has valid MX records and the SMTP check passed. Should I check if it's a disposable email address?
```

**Prompt:** 
```
Show me the status of our last 5 verification jobs.
```

**Response:** 
```
I've retrieved your recent jobs. 4 are 'Finished' and 1 is 'In Progress' (65% complete). Finished lists include 'Newsletter_Clean_Q1.csv' and 'Leads_Export.txt'. Would you like the results summary for Newsletter_Clean_Q1?
```

**Prompt:** 
```
How many verification credits do I have left?
```

**Response:** 
```
You currently have 12,450 verification credits remaining in your account. Your last purchase was for 20,000 credits on March 1st. Should I list any recently processed files that used these credits?
```

## Capabilities

### Verify single emails
Instantly checks one email address's deliverability and determines if it's disposable.

### Track bulk job status
Retrieves the current progress, results summary, and final outcomes of large file verification jobs.

### Audit list health metrics
Generates a high-level overview of your past verification activity, showing success rates and common invalid patterns.

### Manage account credits
Checks the remaining number of verification credits and organizational quotas for your account.

### View job history
Lists all past, current, and completed email verification files you've uploaded.

## Use Cases

### Preparing for a major product launch email blast
The marketing team has 50,000 leads from a purchased database. Instead of risking bounces and damaging sender reputation, the agent uses `list_verification_jobs` to upload the file, then monitors progress using `get_verification_job_status` until the final results are ready for review.

### Cleaning up data entered by a sales team
A CRM admin needs to validate 20 emails gathered manually over a week. They ask their agent to use `verify_single_email` on each address, getting immediate confirmation if the email is valid and not disposable.

### Investigating a sudden drop in open rates
An operations analyst uses the `quick_verification_health_audit` tool to get a summary of recent failed emails. This points them toward a specific pattern of invalid addresses, solving the mystery faster than manual data sorting.

### Understanding job completion timelines
A project manager needs to know if their last three list cleaning efforts are done. They use `list_latest_verification_jobs` and then check `list_successfully_processed_files` to confirm everything is finished.

## Benefits

- Stop guessing if an email is live. Use the `verify_single_email` tool to instantly check deliverability, resolving MX records and SMTP connections for any contact.
- Manage huge data sets without headaches. Upload files and use tools like `list_verification_jobs` or `get_verification_job_status` to track multi-gigabyte job progress.
- Know your limits before sending. Use `get_remaining_credits` whenever you start a campaign so you never get caught short on verification credits.
- Audit results faster than ever. The `quick_verification_health_audit` tool pulls together high-level success rates, letting you see patterns in invalid emails without digging through logs.
- Keep track of everything. Tools like `list_successfully_processed_files` and `list_in_progress_verification_jobs` give you a clear dashboard view of all your list hygiene efforts.

## How It Works

The bottom line is that you talk to your AI client like you talk to a team member, and it handles all the messy data retrieval for list cleaning.

1. Connect the EmailListVerify MCP to your AI client using your API key.
2. Tell your agent what needs cleaning; for example, 'check this list of 50 emails' or 'show me my current credit balance'.
3. Your agent uses the underlying tools to execute the checks and returns a plain language summary of results.

## Frequently Asked Questions

**How do I check a single email address using EmailListVerify?**
You use the `verify_single_email` tool. Just give your agent the email, and it will instantly report on deliverability, MX records, and whether it's disposable.

**Can I check the status of multiple verification jobs with EmailListVerify?**
Yes, you can. Use `list_verification_jobs` to see all files, then use `get_verification_job_status` for specific updates on job progress.

**Does this MCP help me manage my credits?**
Absolutely. Running `get_remaining_credits` is the best way to check your current balance and ensure you don't run out of verification quotas mid-campaign.

**What if I want a summary of all bad emails? Use EmailListVerify.**
The `quick_verification_health_audit` tool provides a high-level overview, summarizing activity and identifying common patterns in invalid email addresses across your account history.

**How do I list the most recent files processed?**
Use `list_latest_verification_jobs`. This function quickly shows you the metadata for every file that has been recently uploaded to the platform.