# Kickbox MCP

> Kickbox verifies email addresses in real time or in large batches to keep your mailing lists accurate and deliverable. Stop sending emails that bounce off invalid accounts. Use this MCP to instantly check if an address is safe, disposable, or undeliverable before you hit send, protecting your sender reputation.

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

## Description

Sending bulk emails requires clean data. You need to know which addresses are actually live inboxes and which ones will just bounce back. This connector lets your agent validate email lists, whether you're checking a single contact or processing thousands of records at once. It identifies risky addresses, like throwaway accounts or generic role names, so your campaigns hit the right people every time. You simply ask your AI client to check data, and it handles the validation process automatically. This makes list scrubbing simple—you don't need complex API calls or dedicated database jobs. Just connect this MCP through Vinkius and let your agent take care of the dirty work.

## Tools

### get_batch_status
Retrieves the current progress and status of a running batch verification job using its unique Job ID.

### start_batch_verification
Begins a large job to verify an entire list of emails, returning an ID you can track later.

### verify_email
Checks whether a single email address is valid for receiving mail right now.

## Prompt Examples

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

**Response:** 
```
I've checked the email. The status for 'test@example.com' is 'deliverable'. It is safe to send to this address.
```

**Prompt:** 
```
Start a batch verification for these emails: ['user1@gmail.com', 'user2@outlook.com', 'invalid-email@test'].
```

**Response:** 
```
The batch verification job has been started. Your Job ID is 123456. You can check its progress using the get_batch_status tool.
```

**Prompt:** 
```
What is the status of my Kickbox batch job 123456?
```

**Response:** 
```
The job 123456 is currently 'completed'. 100% of the emails have been processed. You can download the full report here: [Download URL].
```

## Capabilities

### Check a single email address
Instantly confirms if one specific email is deliverable, undeliverable, or risky.

### Process entire mailing lists
Runs large-scale jobs to validate thousands of addresses in a single batch operation.

### Monitor job progress
Tracks the status of your background batch verification tasks until they are complete.

## Use Cases

### New list acquisition needs cleaning
A marketing team just uploaded a new lead file of 10,000 contacts. Instead of risking sending to invalid addresses, they ask their agent to `start_batch_verification` on the entire list first. Once complete, the clean data is ready for campaign use.

### Pre-sending check for a single prospect
An SDR pulls up a contact's email address during a call. They immediately ask their agent to `verify_email` using that specific address, confirming it’s active and safe before sending the follow-up pitch.

### Debugging failed campaigns
The campaign bounce rate jumped unexpectedly. The ops engineer uses the status tools to check historical batch jobs, ensuring no data was lost or marked incorrectly during processing.

## Benefits

- Stops wasted emails. By using `verify_email`, you confirm an address is deliverable instantly, saving money on failed campaigns and protecting your sender score.
- Handles massive data sets. If you have thousands of leads, the batch processing tools allow you to run a large job that updates entire mailing lists in one go.
- Saves time tracking jobs. You never lose track of a big verification task. Use `get_batch_status` to monitor progress without manually checking dashboards until results are ready.
- Reduces bounce rates. Identifying disposable or invalid addresses upfront means your marketing automation platform only sends messages that actually count.
- Protects reputation. This MCP helps you filter out dangerous addresses—like role-based accounts—keeping your sender score high for future outreach.

## How It Works

The bottom line is: you start the job, track its status using the returned Job ID, and then retrieve the final, clean list of verified addresses.

1. First, you initiate a large-scale check by telling your agent to start a batch job for your list.
2. Next, the system processes the addresses and gives you a Job ID. You then use that ID to monitor progress until it reports completion.
3. Finally, once complete, you pull the full results report showing which emails passed validation and which ones failed.

## Frequently Asked Questions

**Can I check if a single email address is valid before adding it to my database?**
Yes! Use the `verify_email` tool with the email address. The agent will return real-time results indicating if the email is deliverable, undeliverable, or risky.

**How do I verify a large list of emails at once?**
You can use the `start_batch_verification` tool. Provide an array of email addresses, and the server will start a background job and return a Job ID for tracking.

**How can I check if my batch verification job is finished?**
Use the `get_batch_status` tool with your Job ID. It will provide the current status (processing, completed, etc.), progress percentage, and a download URL if the job is done.

**What do I need to know about authentication when using `verify_email`?**
You must provide a valid Kickbox API key in your agent's configuration. This ensures that your AI client can authorize the request and access the verification service.

**If I run `start_batch_verification`, does it have any rate limits or quotas?**
Kickbox enforces standard rate limiting to protect its infrastructure. For extremely high-volume processing, check the official documentation for recommended batch sizes and throttling guidelines.

**After using `get_batch_status`, how do I retrieve the actual results file?**
Once the job status is 'completed', the returned data object will contain a download URL. Use that specific link to fetch the full, processed report containing all email outcomes.

**What happens if an address provided to `verify_email` is malformed or invalid?**
The tool returns a specific error code and message explaining the formatting issue. This prevents sending data that doesn't follow standard email syntax, helping you clean input proactively.

**Can I use this MCP for workflows beyond my AI client (e.g., custom scripts)?**
This MCP is built as an open standard protocol. Any application that can interact with the Model Context Protocol framework can call its tools, allowing integration into various non-AI systems.