VerificationFree

check_domain_health

Check email-domain health (MX / SPF / DMARC)

Inspect a domain’s MX, SPF, and DMARC records and overall health score. Free, no mailbox check.

Get an API key + 100 free credits Connect the MCP server

When an agent uses check_domain_health

Use check_domain_health to diagnose a domain rather than a single mailbox: is it set up to receive mail at all, and is it configured to send authenticated mail? Agents use it to explain why an address on a domain bounces, to vet a prospect domain in bulk, or to validate the agent operator’s own sending domain before a campaign. It reads DNS only, so it costs no credits and verifies no individual mailbox.

REST endpoint

GET /api/tools/domain-health?domain={domain}

Credit cost

Free

Input schema

Field	Type	Required	Description
`domain`	string	required	Domain to check, e.g. example.com.

Call it over MCP

An MCP client invokes the tool with a tools/call request. Hosted clients send this to https://verifly.email/mcp with your Authorization: Bearer vf_… header; the verifly-mcp-server package does the same with VERIFLY_API_KEY set.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_domain_health",
    "arguments": {
      "domain": "example.com"
    }
  }
}

Posting that same call straight to the hosted endpoint:

curl -s -X POST "https://verifly.email/mcp" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_domain_health","arguments":{"domain":"example.com"}}}'

Equivalent raw REST call

Under the hood this tool calls GET /api/tools/domain-health?domain={domain}. If you are not using MCP, hit the REST API directly:

curl -s "https://verifly.email/api/tools/domain-health?domain=example.com" \
  -H "Authorization: Bearer vf_your_api_key"

What you get back

A JSON object describing the domain’s MX records, SPF and DMARC presence/validity, and an overall health score / verdict.

Required input: domain.

Related tools

verify_email

Real-time deliverability verdict for one email — valid / invalid / risky / unknown with detailed flags.

Open verify_batch

Synchronously verify a small list (up to a few hundred) and get a verdict per address in one call.

Open get_account

The account profile for the current key: email, credits, total used, key count, and plan. Free.

Open

Use check_domain_health in your agent

Verifly is the only email verifier with a hosted MCP server plus autonomous agent self-registration. An agent can call register_account for an instant key and 100 free credits, then start calling check_domain_health — no human, no dashboard.

Connect the MCP server Read the agent guide