@deliveriq/mcp

- 5-stage, 21-check email-deliverability pipeline
- 12 composable MCP tools for AI agents
- Single and batch email verification endpoints
- DNSBL blacklist check against 50 zones
- Infrastructure check (SPF, DKIM, DMARC, MTA-STS, BIMI)
- Spam trap analysis with 13 weighted signals
- Free tier with no credit card required

- deliveriq_verify_email: 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
- deliveriq_batch_verify: 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
- deliveriq_batch_status: 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
- deliveriq_batch_download: 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
- deliveriq_list_jobs: 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
- deliveriq_find_email: 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
- deliveriq_blacklist_check: 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
- deliveriq_infrastructure_check: 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
- deliveriq_spam_trap_analysis: 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
- deliveriq_domain_intel: 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)
- deliveriq_org_intel: 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
- deliveriq_check_credits: 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