Verifly Email Verification

Verify email addresses from your AI agent: deliverable, risky, disposable, role and catch-all checks with pay-as-you-go credits and no monthly plan.

Hosted MCP Server

npx add-mcp 'https://verifly.email/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

The Verifly MCP server for AI agents

Give any MCP-capable agent a complete email-verification toolbox. Connect the hosted server at https://verifly.email/mcp over Streamable HTTP, or run npx verifly-mcp-server locally. Verifly is the only email verifier with a hosted MCP server, autonomous agent self-registration, and agent-native crypto pay.

One-click connect

Hosted server (any MCP client)

Streamable HTTP. Send your Verifly key as a bearer token.

{
  "mcpServers": {
    "verifly": {
      "url": "https://verifly.email/mcp",
      "headers": {
        "Authorization": "Bearer vf_your_api_key"
      }
    }
  }
}

Claude Desktop / Cursor (npm, stdio)

Add to claude_desktop_config.json or your Cursor MCP config.

{
  "mcpServers": {
    "verifly": {
      "command": "npx",
      "args": ["-y", "verifly-mcp-server"],
      "env": {
        "VERIFLY_API_KEY": "vf_your_api_key"
      }
    }
  }
}

Call a tool directly over HTTP

Standard MCP tools/list and tools/call JSON-RPC over 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":"verify_email","arguments":{"email":"lead@example.com"}}}'

15 tools

Every tool below has its own reference page with input schema, an MCP tools/call example, the equivalent raw curl, and its credit cost.

Verification

[

verify_email 1 credit

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

Open](https://verifly.email/mcp/verify_email)[

verify_batch 1 credit / email

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

Open](https://verifly.email/mcp/verify_batch)[

check_domain_health Free

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

Open](https://verifly.email/mcp/check_domain_health)

List hygiene

[

clean_email_list Free

Dedupe, drop invalid syntax, and optionally strip disposable and role accounts — no verification, free.

Open](https://verifly.email/mcp/clean_email_list)[

extract_emails Free

Pull every email address out of a block of free-form text, optionally deduped and lowercased. Free.

Open](https://verifly.email/mcp/extract_emails)

Bulk jobs

[

submit_bulk 1 credit / email

Queue a large list (up to 1M) as an async job — returns a job_id to poll. Optional completion webhook.

Open](https://verifly.email/mcp/submit_bulk)[

get_job_status Free

Poll one bulk job by job_id for status, percent progress, and a running valid/invalid/risky summary. Free.

Open](https://verifly.email/mcp/get_job_status)[

get_job_results Free

Fetch the full per-address results of a completed bulk job by job_id, plus the summary. Free.

Open](https://verifly.email/mcp/get_job_results)[

list_jobs Free

List the account’s bulk jobs, newest first, with status and summary. Filter by status, paginate. Free.

Open](https://verifly.email/mcp/list_jobs)

Account & usage

[

get_credits Free

Check the API key’s remaining verification credits, recent usage, and plan. Free.

Open](https://verifly.email/mcp/get_credits)[

get_usage Free

Usage over a period (day / week / month): credits, emails, requests by endpoint and source, daily breakdown. Free.

Open](https://verifly.email/mcp/get_usage)[

get_account Free

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

Open](https://verifly.email/mcp/get_account)

Billing

[

get_packages Free

List the credit packages available for purchase — id, credits, USD price, and price per 1k. Free.

Open](https://verifly.email/mcp/get_packages)[

buy_credits Free to call

Start a credit purchase: Stripe checkout link (human needed) or crypto invoice with a raw wallet address an agent can pay autonomously.

Open](https://verifly.email/mcp/buy_credits)

Onboarding

[

register_account Free (no API key required)

Create a brand-new Verifly account with no human in the loop — returns an API key and free starter credits.

Open](https://verifly.email/mcp/register_account)

Built for fully autonomous agents

Most verifiers assume a human signs up, copies a key out of a dashboard, and pays with a card. Verifly does not. An agent can run the entire lifecycle itself:

  1. 1.register_account — mint a brand-new account + API key with 100 free credits, no human in the loop.
  2. 2.verify_email / verify_batch / submit_bulk — verify one address, a batch, or millions async.
  3. 3.get_credits running low? buy_credits with method crypto returns a raw wallet address the agent pays directly — credits land automatically.

[

Official MCP Registry

Find the verifly-mcp-server listing in the Official MCP Registry.

Open](https://registry.modelcontextprotocol.io/?search=verifly-mcp-server)[

npm package

npx verifly-mcp-server — published on npm.

Open](https://www.npmjs.com/package/verifly-mcp-server)[

Source on GitHub

Server source, stdio + Streamable HTTP transports.

Open](https://github.com/james-sib/verifly-mcp-server)[

OpenAPI spec

The REST API every MCP tool maps onto.

Open](https://verifly.email/openapi.json)

Try in your agent

Paste this into Claude Desktop / Cursor MCP config, or call the hosted streamable HTTP endpoint from any agent runtime.

{
  "mcpServers": {
    "verifly": {
      "url": "https://verifly.email/mcp",
      "headers": { "Authorization": "Bearer vf_your_api_key" }
    }
  }
}

No key yet? Agents can self-register via register_account (100 free credits). See /docs/examples.