MCP Server

Official4 toolsLive

by pingvalid

Email validation for Claude and any MCP client — verdicts with evidence, bulk jobs, refunds.

Captured live from the server via tools/list.

pingvalid_validate_email

Validate a single email address. Returns a deliverability verdict (valid/risky/invalid/unknown) with tier-by-tier evidence and a 0–100 risk score. Spends 1 credit (2 on deep); cache hits are free on quick/standard.

Parameters2

email	string	required	Email address to validate. Internationalized (SMTPUTF8) supported.
tier	string	optional	Pricing depth: quick (T1–T5) \| standard (T1–T6, default) \| deep (T1–T7).

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "minLength": 3,
      "maxLength": 320,
      "description": "Email address to validate. Internationalized (SMTPUTF8) supported."
    },
    "tier": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "deep"
      ],
      "default": "standard",
      "description": "Pricing depth: quick (T1–T5) | standard (T1–T6, default) | deep (T1–T7)."
    }
  },
  "required": [
    "email"
  ]
}

pingvalid_submit_bulk_job

Submit up to 1000 email addresses for asynchronous validation. Returns immediately with a job_id; poll pingvalid_get_job_status or register a webhook_url. Requires a Bearer key with the validate:bulk scope.

Parameters4

emails	array	required	Up to 1000 email addresses to validate in one batch.
tier	string	optional
webhook_url	string	optional	Optional HTTPS URL — receives an HMAC-signed completion event.
legitimate_interest	boolean	required	Must be true. Asserts the submitter has a legitimate interest in validating these addresses (required by the Terms of Service).

Raw schema

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 320
      },
      "minItems": 1,
      "maxItems": 1000,
      "description": "Up to 1000 email addresses to validate in one batch."
    },
    "tier": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "deep"
      ],
      "default": "standard"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Optional HTTPS URL — receives an HMAC-signed completion event."
    },
    "legitimate_interest": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. Asserts the submitter has a legitimate interest in validating these addresses (required by the Terms of Service)."
    }
  },
  "required": [
    "emails",
    "legitimate_interest"
  ]
}

pingvalid_get_job_status

Poll a bulk validation job: progress percent, per-verdict counts, accumulated cost, and a results_url (NDJSON) once completed. Free to call. Requires the read:results scope.

Parameters1

job_id

string

required

Job id returned by pingvalid_submit_bulk_job.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "description": "Job id returned by pingvalid_submit_bulk_job."
    }
  },
  "required": [
    "job_id"
  ]
}

pingvalid_explain_verdict

Render a natural-language explanation of a verdict you already received from pingvalid_validate_email. Pure transformation — no credits charged. Requires the validate:single scope.

Parameters4

email	string	required
verdict	string	required
risk_score	integer	required
tier_results	object	required	The tier_results map from a prior validate call.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    },
    "verdict": {
      "type": "string",
      "enum": [
        "valid",
        "risky",
        "invalid",
        "unknown"
      ]
    },
    "risk_score": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "tier_results": {
      "type": "object",
      "description": "The tier_results map from a prior validate call."
    }
  },
  "required": [
    "email",
    "verdict",
    "risk_score",
    "tier_results"
  ]
}

Install

Tools (4)

pingvalid_validate_emailpingvalid_submit_bulk_jobpingvalid_get_job_statuspingvalid_explain_verdict

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://pingvalid.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pingvalid.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.