Claude Code

claude mcp add --transport http billionverify https://mcp.billionverify.com/mcp

/mcp

npm install -g billionverify
bv config set api-key YOUR_API_KEY

I'll verify that email address for you.

Using the verify_email tool...

✅ john@example.com is VALID
- Deliverable: Yes
- Disposable: No
- Score: 0.95

This email appears to be valid and safe to use.

Let me read your .env file and verify any email addresses found.

Reading .env...
Found 3 email addresses:
- TEST_EMAIL=user@example.com
- ADMIN_EMAIL=admin@company.com
- SUPPORT_EMAIL=help@temp-mail.org

Verifying each one...

| Email | Status | Notes |
|-------|--------|-------|
| user@example.com | Unknown | Example domain |
| admin@company.com | Valid | Corporate email |
| help@temp-mail.org | Invalid | Disposable email |

Recommendation: Replace the temp-mail address with a real email for testing.

I'll process your contacts.csv file and verify each email.

Reading contacts.csv... Found 150 email addresses.

Verifying emails (this may take a moment)...

Results:
- Valid: 142 emails
- Invalid: 5 emails
- Unknown: 3 emails

Creating cleaned_contacts.csv with valid emails only...
Done! Removed 8 problematic emails.

Invalid emails removed:
- fake@asdfgh.xyz (domain doesn't exist)
- test@mailinator.com (disposable)
- bounce@invalid.net (mailbox not found)
...

Let me check your test fixtures for email addresses.

Scanning test/ directory...
Found emails in test/fixtures/users.json

Verifying 5 test emails...

⚠️ Warning: Found potential issues:

1. test@mailinator.com - This is a disposable email
   Consider using @example.com for test fixtures (RFC 2606 reserved)

2. admin@real-company.com - This appears to be a real company email
   You probably don't want real emails in your test fixtures

Suggestions:
- Use @example.com, @example.org for test emails
- Use user{n}@example.com pattern
- Never use real company emails in tests

I'll create a pre-commit hook for email verification.

Creating .husky/pre-commit...

#!/bin/sh
# Check for new email addresses in config files
emails=$(git diff --cached --diff-filter=ACMR -- "*.json" "*.yaml" "*.env*" | \
  grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}')

if [ -n "$emails" ]; then
  echo "Verifying new email addresses..."
  for email in $emails; do
    result=$(bv verify "$email" --quiet)
    if [ $? -eq 1 ]; then
      echo "❌ Invalid email found: $email"
      exit 1
    fi
  done
  echo "✅ All emails verified"
fi

Done! The hook will verify emails before each commit.

I'll add an email verification step to your workflow.

Updating .github/workflows/ci.yml...

- name: Verify Test Emails
  env:
    BV_API_KEY: ${{ secrets.BV_API_KEY }}
  run: |
    npm install -g billionverify
    # Extract and verify emails from test fixtures
    grep -rhoE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' test/ | \
      sort -u | while read email; do
        if ! bv verify "$email" --quiet; then
          echo "Invalid email in tests: $email"
          exit 1
        fi
      done

Don't forget to add BV_API_KEY to your repository secrets.