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.register_account — mint a brand-new account + API key with 100 free credits, no human in the loop.
- 2.verify_email / verify_batch / submit_bulk — verify one address, a batch, or millions async.
- 3.get_credits running low? buy_credits with method
cryptoreturns 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.