Spiral gives your agent every tool with one account. Browse the tools →

Claude Code · Lead Gen

How to Use BounceBan email verification in Claude Code

BounceBan assesses one email address and returns a deliverability result, confidence score, and mailbox flags. Use it to check a public business inbox, including addresses on catch-all domains or behind secure email gateways.

Prompts to try with BounceBan email verification in Claude Code

Copy an example into Claude Code, or ask in your own words.

Use BounceBan email verification to check [email protected], then add the returned result and score to the supplier review screen in this project.

BounceBan email verificationClaude Code
Try asking
  • Check [email protected] with BounceBan email verification and write a small report showing its result, score, role flag, and catch-all flag.

  • Use BounceBan email verification for [email protected] and update our contact review component to display the returned SMTP provider and MX records when available.

  • Run BounceBan email verification for [email protected], then add a review branch in our contact import code for each of the four assessment states.

  • Use BounceBan email verification to assess [email protected] and update our directory validation code so the catch-all flag alone cannot reject an address.

How to set up BounceBan email verification in Claude Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run BounceBan email verification

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "bounceban/people/email-verify",
        "input": {
          "email": "<email>"
        }
      }'

Then paste one of the prompts above: Claude Code finds BounceBan email verification on Spiral, shows the price and runs it.

BounceBan email verification providers and prices

Spiral runs BounceBan email verification through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
BounceBan · Email verifier
bounceban/people/email-verify

Settings you can ask for

Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Moderegular or deepverify

regular (default) or deepverify. deepverify assumes the domain is the person's current employer's, which helps with accept-all domains.

Every API field of BounceBan · Email verifier is on its tool page: open its card above.

What can you do with BounceBan email verification in Claude Code?

Add an email review step to a supplier directory using BounceBan's result, score, and mailbox flags. A coding agent can store the assessment in your project and keep catch-all detection separate from the decision to flag an address.

Review supplier contact details

Check a supplier's public business inbox before approving its contact record. Put risky and undeliverable results in a review queue.

Audit a business directory

Assess a submitted public business address before publishing it in a directory. Show the deliverability assessment separately from the role and catch-all flags.

Reassess catch-all addresses

Review a business inbox previously rejected solely because its domain accepts all addresses. Use BounceBan's result to decide whether it still needs review.

Investigate a bounced vendor message

Recheck the vendor's public inbox after a bounce. Compare the assessment with the bounce message to investigate an address problem or a sender reputation issue.

Check a public partnership inbox

Assess a published business address before preparing a partnership inquiry. Include its result and score in the contact review.

Review business contact changes

Recheck a small set of public organization inboxes on a schedule. Flag changes in deliverability or returned mail infrastructure for review.

Questions about BounceBan email verification in Claude Code

Can Claude Code use BounceBan email verification?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run BounceBan email verification like any built-in tool.

How much does BounceBan email verification cost in Claude Code?

$0.003492 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need an Alexandria account to use BounceBan email verification in Claude Code?

No. Spiral runs BounceBan email verification on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up BounceBan email verification in Claude Code?

About two minutes: add the hosted server, then sign in.

Does Claude Code wait while BounceBan email verification runs?

BounceBan email verification runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

Does this check one address or return a contact list?

Single verification checks one email address you supply. Its documented scope is an address assessment, so use it when you already have the business inbox you want to check.

What do the result and score tell me?

BounceBan reports deliverable, risky, undeliverable, or unknown, alongside a score from 0 to 100. Higher scores indicate better assessed deliverability.

Can BounceBan check catch-all business addresses?

Yes. BounceBan covers catch-all domains and secure email gateways, and it can classify catch-all addresses as deliverable. Use the assessment rather than rejecting every address with a catch-all flag.

Does a deliverable result guarantee delivery?

No. BounceBan reports average accuracy of around 97% in its own testing, and sender reputation can still cause a valid address to bounce or be filtered.

Can the same address get a different result later?

Yes. BounceBan says repeat checks of the same list over a short period typically differ for about 0.1% to 0.3% of addresses.

Get started

Start using BounceBan email verification in Claude Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Claude Code:

Set up Claude Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options