ai.verifox/email-verifier

Official6 toolsLive

by verifoxturnix1 · JavaScript

Verify email deliverability & find business emails (single or bulk) via the Verifox API.

ai.verifox/email-verifier MCP Server

The ai.verifox/email-verifier MCP server connects Claude and other AI assistants to the Verifox API to verify email deliverability and find business emails. It supports both single and bulk workflows, with a total of 6 tools exposed by the server.

🛠️ Key Features

Verifies email deliverability via the Verifox API
Finds business emails
Supports single and bulk requests
Exposes 6 tools

🚀 Use Cases

Check whether an email address is deliverable
Enrich or source business email contacts
Run bulk email verification and discovery

⚡ Developer Benefits

Integrates the Verifox API into an MCP-compatible assistant
Enables automation for single and bulk email operations

⚠️ Limitations

Limited to the Verifox email verification/discovery scope as described
Details beyond deliverability verification and business email finding are not provided

Captured live from the server via tools/list.

verify_email

Verify whether ONE email address is deliverable. Checks syntax, MX, SMTP, catch-all, disposable, free-provider and role detection, and returns a 0-100 quality score. Charges 1 Fox Credit per uncached email.

Parameters2

email	string	required	Email address to verify
proxy	boolean	optional	Use a SOCKS5 proxy for the SMTP check

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Email address to verify"
    },
    "proxy": {
      "type": "boolean",
      "description": "Use a SOCKS5 proxy for the SMTP check"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_emails

Bulk-verify a LIST of email addresses. Submits the whole list, waits for completion, and returns one result per email (same fields as verify_email). Best for cleaning lead lists. Charges 1 Fox Credit per email. Large lists that don't finish quickly return a jobId to poll with get_job.

Parameters2

emails	array	required	Email addresses to verify
wait	boolean	optional	Wait for results in this call (default true). Set false to just get a jobId.

Raw schema

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "email"
      },
      "minItems": 1,
      "maxItems": 100000,
      "description": "Email addresses to verify"
    },
    "wait": {
      "type": "boolean",
      "description": "Wait for results in this call (default true). Set false to just get a jobId."
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_email

Find ONE person's business email from their name and company domain. Generates ~50 permutations and SMTP-verifies each, waits for the result, and returns the best match (or not_found). Charges 10 Fox Credits per find.

Parameters4

first_name	string	required	Person's first name
last_name	string	required	Person's last name
domain	string	required	Company domain, e.g. stripe.com
middle_name	string	optional	Optional middle name for more permutations

Raw schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "description": "Person's first name"
    },
    "last_name": {
      "type": "string",
      "description": "Person's last name"
    },
    "domain": {
      "type": "string",
      "description": "Company domain, e.g. stripe.com"
    },
    "middle_name": {
      "type": "string",
      "description": "Optional middle name for more permutations"
    }
  },
  "required": [
    "first_name",
    "last_name",
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_emails

Bulk-find business emails for a LIST of contacts (name + company domain each). Submits the list, waits for completion, and returns the found email per contact. Up to 1000 contacts. Charges 10 Fox Credits per contact. Large lists that don't finish quickly return a jobId to poll with get_job.

Parameters2

contacts	array	required	Contacts to find emails for
wait	boolean	optional	Wait for results in this call (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "first_name": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Full name (alternative to first_name/last_name)"
          },
          "middle_name": {
            "type": "string"
          },
          "domain": {
            "type": "string",
            "description": "Company domain"
          }
        },
        "required": [
          "domain"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 1000,
      "description": "Contacts to find emails for"
    },
    "wait": {
      "type": "boolean",
      "description": "Wait for results in this call (default true)"
    }
  },
  "required": [
    "contacts"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credits

Get the current Fox Credit balance for the Verifox account tied to the API key. Free — no credits charged. Use it to check remaining balance before a big verify/find run (verify = 1 credit/email, find = 10 credits/contact).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_job

Check an async job started by verify_emails, find_email, or find_emails. Returns results if finished, otherwise the current status. Use the type shown in the submitting tool's response.

Parameters2

job_id	string	required	Job ID from verify_emails / find_email / find_emails
type	string	required	Job type: verify_bulk, find_single, or find_bulk

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job ID from verify_emails / find_email / find_emails"
    },
    "type": {
      "type": "string",
      "enum": [
        "verify_bulk",
        "find_single",
        "find_bulk"
      ],
      "description": "Job type: verify_bulk, find_single, or find_bulk"
    }
  },
  "required": [
    "job_id",
    "type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

Verifox MCP Server

MCP (Model Context Protocol) server that gives Claude and other AI assistants the Verifox API — verify email deliverability and find business emails, both single and in bulk.

Quick start (published package)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json) or Claude Code MCP config — no install needed, npx fetches it:

json

{
  "mcpServers": {
    "verifox": {
      "command": "npx",
      "args": ["-y", "verifox-mcp"],
      "env": {
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

Get a free API key (1,000 credits) at https://verifox.ai/dashboard/api. Restart Claude Desktop and ask it to "verify these emails".

Tools

Tool	Does	Credits
`verify_email`	Verify ONE email — SMTP deliverability, catch-all, disposable, role, free + 0-100 score	1 / email
`verify_emails`	Bulk-verify a LIST — submits, waits, returns one result per email	1 / email
`find_email`	Find ONE business email from name + company domain (best match or not_found)	10 / find
`find_emails`	Bulk-find emails for a LIST of contacts (name + domain each)	10 / contact
`get_credits`	Check the account's remaining Fox Credit balance	free
`get_job`	Poll a long-running `verify_emails` / `find_email` / `find_emails` job for results	—

Verify and find are async for large lists: the bulk tools wait ~55s inline, and hand back a jobId to finish via get_job if a job runs longer. Cached verifications cost 0 credits.

Local development

Run straight from source with Bun (no build):

bash

cd mcp
bun install

json

{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"

```json
{
  "mcpServers": {
    "verifox": {
      "command": "bun",
      "args": ["run", "/FULL/PATH/TO/Verifox-api/mcp/src/index.ts"],
      "env": {
        "VERIFOX_API_URL": "https://api.verifox.ai",
        "VERIFOX_API_KEY": "foxkey_your_key_here"
      }
    }
  }
}

VERIFOX_API_URL defaults to https://api.verifox.ai when unset. For local development against the API on port 8001, set it to http://localhost:8001.

3. Restart Claude Desktop

The tools will appear in Claude's tool list.

Remote (HTTP) mode

The same server also runs as a streamable-HTTP MCP endpoint (for Smithery, claude.ai connectors, and other remote MCP clients). Set MCP_TRANSPORT=http (or a PORT) and it listens on POST /mcp with a GET /health check:

bash

MCP_TRANSPORT=http PORT=8080 node dist/index.js
# or: docker build -t verifox-mcp . && docker run -p 8080:8080 verifox-mcp

In HTTP mode the Verifox API key is read per request from the Authorization: Bearer <foxkey> header (also accepts x-api-key or ?api_key=) — so one hosted endpoint serves many users, each on their own credits.

Usage Examples

In Claude Desktop, just ask:

"Scan stripe.com for security issues"
"Check if john@google.com is a valid email"
"Score these emails: admin@stripe.com, test@mailinator.com, john.doe@microsoft.com"
"Find the email for Patrick Collison at stripe.com"
"Run OSINT on tesla.com — find subdomains and emails"
"Test the email server for turnix.co"
"Check DMARC policy for google.com"

Environment Variables

Variable	Default	Description
`VERIFOX_API_URL`	`https://api.verifox.ai`	Verifox API base URL
`VERIFOX_API_KEY`	(empty)	Per-user API key (`foxkey_*`), sent as `x-api-key`

Generate a foxkey_* key from the Verifox dashboard (API Keys). The key authenticates every tool call and is the account whose Fox Credits are charged (verify and find cost 1 credit each; scoring and DNS scans are free).

Install

Tools (6)

verify_emailverify_emailsfind_emailfind_emailsget_creditsget_job

Configuration

Environment variables

VERIFOX_API_KEYrequiredsecret

Your Verifox API key (foxkey_...). Get 1,000 free credits at https://verifox.ai/dashboard/api

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "email-verifier": {
      "command": "npx",
      "args": [
        "-y",
        "verifox-mcp@1.2.1"
      ],
      "env": {
        "VERIFOX_API_KEY": "<YOUR_VERIFOX_API_KEY>"
      }
    }
  }
}

ai.verifox/email-verifier MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

verify_email

verify_emails

find_email

find_emails

get_credits

get_job

Verifox MCP Server

Quick start (published package)

Tools

Local development

3. Restart Claude Desktop

Remote (HTTP) mode

Usage Examples

Environment Variables

Install

Configuration

Related servers