Model Context Protocol

HeroBounce for AI Assistants

Give Claude, Cursor, and any MCP-compatible AI agent the ability to validate emails and find contacts - directly from conversation, without writing a line of integration code.

Email validation inside your AI workflow

No webhooks, no API wrappers. The MCP integration lets AI assistants call HeroBounce as a native tool - the same way they search the web or read files.

Zero integration code

Paste one URL or run one npx command. The server handles auth, retries, and response formatting automatically.

Find + verify in one step

Ask Claude to find and validate emails for a list of contacts. It calls find_email and validate_email in sequence - no manual wiring.

Same credits, same quality

MCP calls go through the same live SMTP engine as the dashboard and REST API. No sandbox, no degraded results.

Two ways to connect

Use the remote URL for Claude Desktop. Use the npm package for Cursor, Windsurf, Claude Code CLI, or any stdio-based client.

Option 1 - Remote URL
Claude Desktop (new Connectors panel) - no install required
Recommended
  1. 1In Claude Desktop, click the connector icon → + → Add custom connector.
  2. 2Set Name to HeroBounce and paste this as the Remote MCP server URL:
https://herobounce.com/api/v1/mcp/sse
  1. 3Click Add. Claude Desktop opens a browser where you log in to HeroBounce and click Authorize. No API key to copy - auth happens automatically via OAuth.

Credits are charged to your account automatically per call. Manage access at dashboard - API keys.

Option 2 - npm package (stdio)
Cursor, Windsurf, Claude Code CLI, Cline, Continue, and older Claude Desktop

Add to your MCP config file (~/.cursor/mcp.json for Cursor, claude_desktop_config.json for older Claude Desktop, etc.):

Mac / Linux
{
  "mcpServers": {
    "herobounce": {
      "command": "npx",
      "args": ["-y", "@herobounce/mcp"],
      "env": {
        "HEROBOUNCE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Windows
{
  "mcpServers": {
    "herobounce": {
      "command": "npx.cmd",
      "args": ["-y", "@herobounce/mcp"],
      "env": {
        "HEROBOUNCE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Node.js 18+ required. The package is downloaded automatically on first run via npx - no separate install step needed.

Available tools

Three tools cover the full HeroBounce feature set.

validate_email1 credit

Validate a single email address via live SMTP verification. Returns status (valid / invalid / risky), confidence score, provider, catch-all detection, and spam trap flags. Results cached 24 h - repeat checks are free.

Parameters
emailstringThe email address to validate
validate_emails1 credit per email

Validate up to 50 email addresses in a single call. Returns per-email results plus an aggregate summary of valid / invalid / risky counts. Useful when Claude needs to clean a list mid-task.

Parameters
emailsstring[]Array of email addresses (max 50)
find_email10 credits if found

Discover and verify the professional email address for a person given their name and company domain. Uses pattern discovery and live SMTP verification. No charge if no email is found.

Parameters
first_namestringPerson's first name
last_namestringPerson's last name
domainstringCompany domain, e.g. acme.com

What you can ask Claude

Once connected, describe what you need in plain English.

“Validate john@acme.com and tell me if it is safe to send to.”

Single validation - returns status, confidence, and deliverability.

“I have this list of 20 emails from a form export. Validate all of them and give me only the valid ones.”

Batch validation up to 50 emails per call.

“Find the email address for Sarah Chen at stripe.com and verify it.”

find_email + validate_email in sequence, no manual wiring.

“Go through this CSV of prospects, find verified emails for each person, and add a "valid_email" column.”

Multi-step agentic workflow combining file reads and MCP tool calls.

Ready to connect?

Get your API key in under 60 seconds. 100 free credits included - no credit card required.