email-verifier

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.

{
  "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#"
}

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.

{
  "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 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.

{
  "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#"
}

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.

{
  "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 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).

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

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.

{
  "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#"
}