Skip to content
MCP server

BounceBan MCP by usefulapi

Check BounceBan credits, verify emails and read asynchronous bulk verification results.

Install
Runs
Remotely
Version
1.11.0
Listing updated
4 days ago

About BounceBan MCP by usefulapi

BounceBan MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http bounceban https://bounceban.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://bounceban.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bounceban": {
      "url": "https://bounceban.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "bounceban": {
      "type": "http",
      "url": "https://bounceban.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "bounceban": {
      "serverUrl": "https://bounceban.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "bounceban": {
      "type": "http",
      "url": "https://bounceban.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (6)

Read directly from the server.

bounceban_account
Read verification credit balance and account rate limits without starting verification. Limits and credit balance are shared across the account's API keys.
bounceban_verify_email
Verify one email in regular mode. Costs verification credits on each request, including repeats, and requires confirm:true. Uses the standard API's 15-second result window; returns a final result or a queue/verifying task ID. Read that existing ID with bounceban_single_status later. Never resubmit simply because it is still pending. Basic-only mode can return unknown with score -1 for catch-all/SE
bounceban_single_status
Read an existing single verification ID without spending verification credits. Returns success, verifying or queue. Honor try_again_at when provided; poll no more than 10 times for an ID within 5 minutes, then stop. Results remain available for 90 days. This tool never starts another verification.
bounceban_create_bulk_verification
Submit 1–1,000 emails for regular-mode asynchronous verification. Starts a task and can consume verification credits; requires confirm:true. Check the dashboard before resubmitting after a lost/invalid response. greylisting_bypass:auto balances speed and accuracy; speed may yield more risky results; robust waits longer. No callbacks or automatic polling are configured.
bounceban_bulk_status
Read progress and aggregate results of an existing bulk task. Does not start verification. Wait between polls and honor account rate limits. importing/verifying status is still pending; finished means the task has ended.
bounceban_bulk_results
Read up to 100 existing email results and a cursor for the next page. Results are retained for 90 days. No verification is started and no following page is fetched automatically. Omit state to get all processed results while a task is running; filtering by state can omit in-progress results. A pending response means wait and check the existing task later.

BounceBan MCP by usefulapi FAQ

How do I add BounceBan MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http bounceban https://bounceban.usefulapi.io/mcp