MCP server
BounceBan MCP by usefulapi
Check BounceBan credits, verify emails and read asynchronous bulk verification results.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://bounceban.usefulapi.io/mcpInstall 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