Sign In Get Started

API & MCP Integration

Integrate BounceRaptor email verification into your applications and AI workflows

REST API

Verify emails programmatically from any language or platform

Verify Email

POST

Verify a single email address. Returns detailed verification status, MX records, and deliverability assessment.

/api/v1/verify-email/
Request Body
{
  "email": "[email protected]",
  "project_id": "optional-project-id"
}

Response

200 OK

Successful verification returns email status, verification layers passed, and spam trap indicators.

Example Response
{
  "email": "[email protected]",
  "status": "valid",
  "syntax_valid": true,
  "mx_valid": true,
  "smtp_verified": true,
  "is_spam_trap": false,
  "is_role_based": false,
  "provider": "Google Workspace"
}

Code Examples

cURL 

curl -X POST \
  https://bounceraptor.com/api/v1/verify-email/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

Python 

import requests

resp = requests.post(
  "https://bounceraptor.com/api/v1/verify-email/",
  headers={
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  json={"email": "[email protected]"}
)

print(resp.json())

JavaScript 

const resp = await fetch(
  "https://bounceraptor.com/api/v1/verify-email/",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      email: "[email protected]"
    })
  }
);

const data = await resp.json();
console.log(data);

Authentication

All API requests require a Bearer token for authentication

Bearer Token

Include your API key in the Authorization header as Bearer YOUR_API_KEY

HTTPS Only

All API traffic is encrypted over HTTPS. Your API keys are never exposed in transit.

MCP Protocol

Model Context Protocol — let AI agents verify emails natively

What is MCP?

The Model Context Protocol (MCP) is an open protocol that enables AI models and agents to interact with external tools and services through a standardized JSON-RPC 2.0 interface. With BounceRaptor's MCP server, your AI assistants can verify email addresses directly within their reasoning loops.

AI agent-native — designed for LLM tool use
JSON-RPC 2.0 over HTTP transport
Automatic tool discovery via tools/list
Structured responses optimized for LLM parsing

MCP Server Configuration

Add this to your MCP client configuration to connect BounceRaptor: 

{
  "mcpServers": {
    "bounceraptor": {
      "serverUrl": "https://bounceraptor.com/api/mcp/verify-email/",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Available MCP Tools

verify-email

Verify a single email address through 3-layer validation. Returns status, MX records, spam trap indicators, and provider info.

input: { email: string }

verify-batch

Verify multiple email addresses in a single call. Asynchronous processing with result tracking.

input: { emails: string[] }

check-status

Query the verification status of a previously submitted batch by its tracking ID.

input: { batch_id: string }

How MCP Works with Your AI Agent

1. Connect

Your AI client discovers BounceRaptor tools via the MCP handshake and tools/list endpoint

2. AI Reasons

When the AI needs email verification, it decides to call the verify-email tool

3. Verify

BounceRaptor performs 3-layer verification and returns structured results via JSON-RPC

4. AI Acts

The AI incorporates verification results into its response or workflow automatically

Get Your API Key

Available on Professional and Unlimited plans

REST API Key

  1. Sign up for a Professional or Unlimited plan
  2. Navigate to Settings → API Keys in your dashboard
  3. Generate a new API key with a descriptive name
  4. Use the key in your Authorization: Bearer header

MCP Server Key

  1. Sign up for a Professional or Unlimited plan
  2. Navigate to Settings → MCP Keys in your dashboard
  3. Create an MCP key for your AI agent
  4. Add the configuration JSON to your MCP client settings

Rate Limits & Quotas

Your plan determines how many verifications you can perform

Plan Monthly Verifications Rate Limit API Access MCP Access
Free 1000 Standard
Starter 10000 Standard
Professional 50000 Standard
Unlimited Unlimited Standard

Start Verifying Emails via API

Get your API key and start integrating in minutes

Get Started for Free
BounceRaptor Logo

Professional email verification platform
Protect your reputation • Maximize deliverability

Product

Company

© 2026 BounceRaptor. All rights reserved.