@deliveriq/mcp

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 [email protected] a valid email?" -> { email: "[email protected]" } - "Deep check on [email protected]" -> { email: "[email protected]", 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: ["[email protected]", "[email protected]", "[email protected]"] } - "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 [email protected] a spam trap?" -> { email: "[email protected]" } 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