BounceProtect

Clean your email lists before you send

Back to Learn
Model Context Protocol

Validate emails directly from Claude, Cursor, and AI coding assistants

How to connect BounceProtect to Claude Desktop, Cursor, and Claude Code using MCP — validate emails without leaving your AI assistant.

🖥️

Claude Desktop

⌨️

Cursor

💻

Claude Code

Advanced Features

Validate emails directly from Claude, Cursor, and AI coding assistants

How to connect BounceProtect to Claude Desktop, Cursor, and Claude Code using the Model Context Protocol (MCP) — validate emails without leaving your AI assistant.

What is the BounceProtect MCP Server?

The BounceProtect MCP server lets you validate email addresses directly inside Claude Desktop, Cursor, and Claude Code — without switching to a browser or writing API calls manually. Just ask your AI assistant to validate an email and it happens instantly in the conversation.

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. Think of it as a universal plugin system for AI — instead of copying and pasting data between your AI tool and other apps, the AI can call external services directly. MCP is supported natively by Claude Desktop, Cursor, Claude Code, and Gemini CLI.

What you can do with the BounceProtect MCP server

Once connected, you can ask your AI assistant natural language questions like:

  • "Validate the email john@acmecorp.com"
  • "Check if these 10 emails are deliverable: [paste list]"
  • "Which of these emails should I not send to?"
  • "How many BounceProtect credits do I have left?"
  • "Clean this list and tell me which ones to remove before I send my campaign"

The AI calls the BounceProtect API automatically and returns the full validation result — status, deliverability score, spam risk score, SMTP result, and send recommendation — right in the conversation.

Available tools

Validate Email

Validate a single email address with full signal breakdown — status, deliverability score, spam risk, SMTP result, and send recommendation.

Validate Emails (Bulk)

Validate up to 100 emails at once. Returns individual results for each with a summary breakdown.

Check Credits

Check your remaining BounceProtect credit balance without leaving your AI assistant.

Setup

1

Get your API key

Go to your BounceProtect dashboard and create a new API key.

2

Find or create the config file

On Mac, open Terminal and run:

bash
open ~/Library/Application\ Support/Claude/

Open or create claude_desktop_config.json.

3

Add the BounceProtect server

Add this to your config file (keep any existing content):

claude_desktop_config.json
{
  "mcpServers": {
    "bounceprotect": {
      "command": "node",
      "args": ["/path/to/bounceprotect-mcp/index.js"],
      "env": {
        "BOUNCEPROTECT_API_KEY": "your-api-key-here"
      }
    }
  }
}
4

Install the server

bash
git clone https://github.com/bounceprotect/bounceprotect-mcp.git
cd bounceprotect-mcp
npm install
5

Restart & verify

Quit completely (Cmd+Q on Mac) and reopen. You should see a hammer icon in the chat input — that confirms BounceProtect is connected.

Example conversation

Validate these emails before I send my outreach: sarah@techcorp.com, hello@tempmail.io, ceo@bigcompany.com
BounceProtect
✅sarah@techcorp.comSend
❌hello@tempmail.ioDo not send
⚠️ceo@bigcompany.comCaution

2 of 3 are safe to send. Remove hello@tempmail.io before sending.

Why use MCP instead of the web app?

If you're already working in Claude or Cursor, MCP keeps you in flow. No switching tabs, no copying and pasting email lists, no manual exports. Your AI assistant handles validation as part of your workflow — whether you're building a campaign, reviewing a prospect list, or cleaning a CRM export.

Credit usage

Each email validated via MCP costs 1 credit, same as the web app and direct API. Results are cached — validating the same email twice won't cost extra credits.

Get started

  1. Create a free account — 100 free credits included
  2. Get your API key
  3. Follow the setup steps above for your AI assistant

Ready to validate your email list?

Start free and check your first emails with full validation signals and SMTP verification.