BounceBan MCP by usefulapi

Read verification credit balance and account rate limits without starting verification. Limits and credit balance are shared across the account's API keys.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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/SEG-protected addresses.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "disable_catchall_verify": {
      "default": false,
      "type": "boolean"
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "emails": {
      "minItems": 1,
      "maxItems": 1000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 254,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "greylisting_bypass": {
      "default": "auto",
      "type": "string",
      "enum": [
        "auto",
        "speed",
        "robust"
      ]
    },
    "disable_catchall_verify": {
      "default": false,
      "type": "boolean"
    },
    "confirm": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "emails"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^[^\\x00-\\x1f\\x7f]+$"
    },
    "state": {
      "type": "string",
      "enum": [
        "deliverable",
        "undeliverable",
        "risky",
        "unknown"
      ]
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}