How to Use BounceBan email verification in Gemini CLI
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 Gemini CLI
Copy an example into Gemini CLI, 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.
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 Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Gemini CLI 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.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Mode | regular 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 Gemini CLI?
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.
More on BounceBan email verification and Gemini CLI
Overview
BounceBan email verification in other agents
Questions about BounceBan email verification in Gemini CLI
Can Gemini CLI use BounceBan email verification?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run BounceBan email verification like any built-in tool.
How much does BounceBan email verification cost in Gemini CLI?
$0.003492 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need an Alexandria account to use BounceBan email verification in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while BounceBan email verification runs?
BounceBan email verification runs in the background. Gemini CLI 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.
Start using BounceBan email verification in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


