# BounceBan MCP by usefulapi

> BounceBan MCP by usefulapi is an MCP server. Check BounceBan credits, verify emails and read asynchronous bulk verification results. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/bounceban/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bounceban
- **MCP Registry name:** io.usefulapi/bounceban
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bounceban.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bounceban": {
      "url": "https://bounceban.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/bounceban-mcp-by-usefulapi
