Model Context Protocol
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.
Hosted MCP endpoint
POST https://verifly.email/mcp over Streamable HTTP with an Authorization: Bearer vf_ header. No install — point any MCP client at it.
npm package
Run npx verifly-mcp-server (stdio) for local clients like Claude Desktop and Cursor. Set VERIFLY_API_KEY and you are connected.
Autonomous self-register
An agent can call register_account to mint its own key + 100 free credits — no human, no dashboard, no captcha.
Agent-native crypto pay
buy_credits returns a raw wallet address an agent can pay from a wallet — top up with no browser and no human.
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_email1 creditReal-time deliverability verdict for one email — valid / invalid / risky / unknown with detailed flags.
Openverify_batch1 credit / emailSynchronously verify a small list (up to a few hundred) and get a verdict per address in one call.
Opencheck_domain_healthFreeInspect a domain’s MX, SPF, and DMARC records and overall health score. Free, no mailbox check.
OpenList hygiene
Bulk jobs
submit_bulk1 credit / emailQueue a large list (up to 1M) as an async job — returns a job_id to poll. Optional completion webhook.
Openget_job_statusFreePoll one bulk job by job_id for status, percent progress, and a running valid/invalid/risky summary. Free.
Openget_job_resultsFreeFetch the full per-address results of a completed bulk job by job_id, plus the summary. Free.
Openlist_jobsFreeList the account’s bulk jobs, newest first, with status and summary. Filter by status, paginate. Free.
OpenAccount & usage
get_creditsFreeCheck the API key’s remaining verification credits, recent usage, and plan. Free.
Openget_usageFreeUsage over a period (day / week / month): credits, emails, requests by endpoint and source, daily breakdown. Free.
Openget_accountFreeThe account profile for the current key: email, credits, total used, key count, and plan. Free.
OpenBilling
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.