verify_email
Verify a single email address
Real-time deliverability verdict for one email — valid / invalid / risky / unknown with detailed flags.
When an agent uses verify_email
Use verify_email the moment an agent has a single address it is about to trust — a new signup, a form submission, a lead pulled from enrichment, or an address a user typed. It returns a deliverability verdict plus the signals an agent needs to branch on (disposable, role account, catch-all, MX, SMTP) so the agent can decide to accept, reject, or ask for a correction before sending or storing the address.
GET /api/v1/verify?email={email}Input schema
| Field | Type | Required | Description |
|---|---|---|---|
email | string | required | The email address to verify, e.g. lead@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": "verify_email",
"arguments": {
"email": "lead@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":"verify_email","arguments":{"email":"lead@example.com"}}}'Equivalent raw REST call
Under the hood this tool calls GET /api/v1/verify?email={email}. If you are not using MCP, hit the REST API directly:
curl -s "https://verifly.email/api/v1/verify?email=lead@example.com" \ -H "Authorization: Bearer vf_your_api_key"
What you get back
A JSON object with is_valid, result (deliverable / undeliverable / risky / unknown), reason, a recommendation (safe_to_send / do_not_send), a details block of boolean flags, and the credits used / remaining.
Required input: email.
Related tools
verify_batchSynchronously verify a small list (up to a few hundred) and get a verdict per address in one call.
Opencheck_domain_healthInspect a domain’s MX, SPF, and DMARC records and overall health score. Free, no mailbox check.
Opensubmit_bulkQueue a large list (up to 1M) as an async job — returns a job_id to poll. Optional completion webhook.
OpenUse verify_email 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 verify_email — no human, no dashboard.