Verify a single email address for deliverability. Returns reachability status (safe/risky/invalid/unknown), a 0-100 score, and detailed checks (syntax, MX, SMTP, disposable, role-based, etc.).

Args:

• email (string): Email address to verify

• skip_smtp (boolean): Skip SMTP check (faster, default: false)

• check_gravatar (boolean): Check for Gravatar profile (default: false)

• check_hibp (boolean): Check Have I Been Pwned breaches (default: false)

• include_intelligence (boolean): Include DNSBL, spam trap, domain age, infrastructure analysis (default: false)

Returns: Markdown report with reachability, score, and check details.

Examples:

• "Is john@acme.com a valid email?" -> { email: "john@acme.com" }

• "Deep check on user@example.com" -> { email: "user@example.com", include_intelligence: true, check_hibp: true }

Credit cost: 1 credit (0 if syntax is invalid)

Error Handling:

• Returns "Authentication failed..." if API key is invalid

• Returns "Insufficient credits..." if balance is 0

Submit a batch of email addresses for asynchronous verification. Returns a job ID for tracking.

Use deliveriq_batch_status to poll progress, and deliveriq_batch_download to get results when complete.

Args:

• emails (string[]): Array of 1-10,000 email addresses

• skip_smtp (boolean): Skip SMTP verification (default: false)

• callback_url (string, optional): Webhook URL for batch.completed/batch.failed events

Returns: Job ID, status, estimated completion time, and status polling URL.

Examples:

• "Verify these 3 emails" -> { emails: ["a@ex.com", "b@ex.com", "c@ex.com"] }

• "Batch verify with webhook" -> { emails: [...], callback_url: "https://my-app.com/webhook" }

Credit cost: 1 credit per email

Check the status and progress of a batch verification job.

Args:

• job_id (string): The job ID from deliveriq_batch_verify

Returns: Job status, progress percentage, and summary when complete.

Examples:

• "Check job abc123" -> { job_id: "abc123" }

Credit cost: Free

Download the results of a completed batch verification job as CSV.

Args:

• job_id (string): The completed job ID

• category (string, optional): Filter to "safe", "risky", "invalid", or "unknown" only

Returns: CSV text with verification results. Large results may be truncated.

Examples:

• "Download results for job abc123" -> { job_id: "abc123" }

• "Get only safe emails from job abc123" -> { job_id: "abc123", category: "safe" }

Credit cost: Free

List batch verification jobs with pagination and optional status filter.

Args:

• page (number): Page number (default: 1)

• limit (number): Results per page (default: 20, max: 100)

• status (string, optional): Filter by "pending", "processing", "completed", "failed", or "cancelled"

Returns: Table of jobs with ID, status, email count, and dates.

Credit cost: Free

Find a person's business email address by name and company domain. Uses pattern generation, SMTP probing, corroboration from public sources, and org intelligence.

Args:

• first_name (string): Person's first name

• last_name (string): Person's last name

• domain (string, optional): Company domain (e.g. "acme.com"). Required if company_name is not set

• middle_name (string, optional): Middle name for disambiguation

• company_name (string, optional): Company name, used to resolve domain if domain is not provided

Returns: Found email address, confidence score and label, verification method, and domain context.

Examples:

• "Find John Doe at acme.com" -> { first_name: "John", last_name: "Doe", domain: "acme.com" }

• "Find Jane Smith at Globex Corp" -> { first_name: "Jane", last_name: "Smith", company_name: "Globex Corp" }

Credit cost: 2 credits per lookup

Check a domain's IP against 50 DNSBL (DNS-based Blackhole List) zones across 6 categories: spam, proxy, dynamic, domain reputation, backscatter, and general.

Args:

• domain (string): Domain to check (e.g. "example.com")

Returns: Listed/clean status, number of hits, and details per zone.

Examples:

• "Is example.com blacklisted?" -> { domain: "example.com" }

Credit cost: 1 credit

Analyze a domain's email infrastructure: SPF, DKIM, DMARC, MTA-STS, BIMI, TLS-RPT records and MX configuration.

Args:

• domain (string): Domain to analyze (e.g. "example.com")

Returns: Infrastructure score (0-100) and detailed analysis of each protocol.

Examples:

• "Check example.com email setup" -> { domain: "example.com" }

Credit cost: 1 credit

Analyze an email address for spam trap risk using 13 signals including domain age, DNSBL listing, disposability, role-based detection, entropy, and email pattern trust.

Args:

• email (string): Email address to analyze

Returns: Risk level (low/medium/high), trap type (pristine/recycled/typo/none), confidence score, and all 13 signals.

Examples:

• "Is user@example.com a spam trap?" -> { email: "user@example.com" }

Credit cost: 1 credit

Get a comprehensive intelligence report for a domain including MX records, DNSBL status, email infrastructure (SPF/DKIM/DMARC), domain age, ISP profile, and trust score.

This is a combined report — if you only need one aspect, use the more specific tools (deliveriq_blacklist_check, deliveriq_infrastructure_check) instead.

Args:

• domain (string): Domain to analyze (e.g. "example.com")

Returns: Complete domain intelligence report with trust score.

Examples:

• "Full report on example.com" -> { domain: "example.com" }

Credit cost: 1 credit (heavy rate limit: 10 req/min)

Query the organization intelligence database for a domain. Returns email patterns, verified contact count, and company name. Free — no credits charged.

This data is populated by the enrichment system. If no data exists, use deliveriq_find_email to trigger enrichment for the domain.

Args:

• domain (string): Company domain (e.g. "acme.com")

Returns: Primary email pattern, confidence, verified contact count, and all observed patterns.

Examples:

• "What email patterns does acme.com use?" -> { domain: "acme.com" }

Credit cost: Free

Check current credit balance, usage breakdown, and plan information. Use this before performing credit-consuming operations to verify sufficient balance.

Returns: Remaining credits, plan tier, billing period, and usage breakdown by category (single, batch, ESP sync).

Examples:

• "How many credits do I have left?" -> {}

• "What's my usage this month?" -> {}

Credit cost: Free