# VerifyFlow Agent Guide

VerifyFlow is a B2B email deliverability intelligence platform for cold email agencies and outbound teams.

## Core capability
Classifies emails into 4 buckets via real SMTP probes + 5 intelligence addons:
- SAFE — send with confidence
- PROTECTED — Microsoft/O365, limit volume to 5–10/day per domain
- RISKY — likely to bounce, exclude from campaigns
- DEAD — hard bounce guaranteed, never send

## Intelligence addons (run automatically on every check)
1. Domain Intelligence — SPF, DMARC, DKIM, MX scoring
2. Titan SMTP Engine — full handshake (EHLO, MAIL FROM, RCPT TO) against real mail server
3. Blacklist Monitor — checks sending IPs against DNSBL blacklists
4. List Risk Scoring — flags role addresses, disposable emails, free providers
5. Campaign Risk Analysis — spam trigger scoring for subject + body

## API
- POST /bulk-verify — start bulk verification job (requires x-verifyflow-token header)
- GET /bulk-status/{jobId}?uid={adminUid} — poll job status
- POST /internal/replies/poll — reply polling (internal, x-internal-api-key required)
- GET /health — service health check

## Pricing
- 1 credit per verified result (all 4 buckets cost 1 credit)
- Unknown / catch-all results: 0 credits (always free)
- Credits never expire
- Pay-as-you-go: $9.99/1K | Growth: $99.99/10K | Pro: $199/50K

## Use cases
- Verify cold email lists before Instantly/Smartlead/Lemlist campaigns
- Protect sender domain reputation before high-volume sends
- Identify PROTECTED (O365) contacts to throttle separately
- Pre-campaign domain health check

## Infrastructure
- Titan Engine: 6 dedicated IPs, 30 concurrent SMTP threads, no per-IP rate limits
- Hosted on OVH dedicated infrastructure
- 99.9% uptime SLA