# Deep Validator

Validates email addresses and URLs in real time using actual DNS, HTTP, and DNSBL checks — something a native LLM cannot do. Returns a clear recommendation (safe / review / block), a confidence score…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add Vannelier/deep-validator

# Browse available tools
npx -y @smithery/cli@latest tool list Vannelier/deep-validator

# Get full schema for a tool
npx -y @smithery/cli@latest tool get Vannelier/deep-validator email.validate

# Call a tool
npx -y @smithery/cli@latest tool call Vannelier/deep-validator email.validate '{}'
```

## Direct MCP Connection

Endpoint: `https://deep-validator--vannelier.run.tools`

**Optional config:**
- `default_follow_redirects` (query) — When validating URLs, follow up to 5 redirect hops and include the chain in the response.
- `default_confirmed` (query) — If false, every validation call returns a dry-run summary; the agent must re-invoke with confirmed.

## Tools (10)

- `email.validate` — Validate a single email: syntax, DNS MX, DNSBL, disposable, WHOIS age.
- `email.validate_bulk` — Validate up to 500 emails. Pre-filter makes obvious-invalid items free.
- `url.validate` — Validate a single URL: DNS + SSRF, HTTP HEAD, redirect chain, risk score.
- `url.validate_bulk` — Validate up to 500 URLs in one request. Returns UrlBulkResponse JSON.
- `mixed.validate_bulk` — Validate up to 500 mixed emails + URLs in one request.
- `domain.validate` — Domain enrichment: MX, SSL, WHOIS age, registrar, disposable/parked.
- `email.validate_from_url` — Validate emails from a remote hosted CSV/XLSX — MCP-friendly replacement for file upload.
- `url.validate_from_url` — Validate URLs from a remote hosted CSV/XLSX — MCP-friendly replacement for file upload.
- `email.classify` — Free heuristic pre-filter for up to 10 000 email strings — no auth, no credits.
- `url.classify` — Free heuristic pre-filter for up to 10 000 URL strings — no auth, no credits.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get Vannelier/deep-validator <tool-name>
```

## Resources

- `deep-validator://service/pricing` — Current per-item pricing and payment rails.
- `deep-validator://service/capabilities` — What Deep Validator checks at each level (DNS, HTTP, DNSBL, SMTP).
- `deep-validator://service/status` — Live health/version data from the hosted service.

## Prompts (2)

- `triage_email_list` (emails) — Workflow: run the free classifier first, then validate only the items that survive pre-filtering. Minimises spend on ob…
- `safety_check_url` (url) — Workflow: fetch a free cost quote, then run full validation with risk scoring and redirect-chain inspection.
