Built for AI agents
Email verification for AI agents
Let Cursor, Claude or your own agent check if an email is real before it sends a message or creates an account. Every result comes with a plain-English reason the agent can pass on.
One-line setup
An MCP server on npm, or a hosted URL. No code to write.
Agents can sign up
An agent gets its own key with 25 free credits, and a person claims it later.
Answers an agent can explain
Status, a plain-English reason, and a suggested fix for typos.
Set it up
Cursor and Claude Desktop
Add this to .cursor/mcp.json or Claude Desktop's claude_desktop_config.json.
{
"mcpServers": {
"bouncelayer": {
"command": "npx",
"args": ["-y", "@bouncelayer/mcp"],
"env": { "BOUNCELAYER_API_KEY": "bl_live_your_api_key" }
}
}
}Claude Code
claude mcp add --transport http bouncelayer https://api.bouncelayer.com/mcp/ \
--header "X-API-Key: bl_live_your_api_key"Any MCP client with remote servers
URL: https://api.bouncelayer.com/mcp/
Header: X-API-Key: bl_live_your_api_keyLet the agent sign itself up
No key yet? The agent can call the create_agent_account tool, or the endpoint below, and start verifying with 25 free credits. It gets a claim link to give to you. Open it to take over the account and unlock the full 300 free checks a month.
The API key and claim link are shown once. Sign-ups are limited per IP. Step-by-step instructions for agents are at /auth.md.
curl -X POST https://api.bouncelayer.com/api/auth/agent/register \
-H "Content-Type: application/json" \
-d '{"type": "anonymous", "label": "my-agent"}'Tools your agent gets
verify_emailCheck one address. Returns a status and a plain-English reason.
submit_bulk_verificationCheck a whole list as a background job.
get_bulk_jobGet a list job's progress and results.
list_bulk_jobsSee recent list jobs.
cancel_bulk_jobStop a list job that's still running.
get_credit_balanceSee how many credits are left.
verify_email_demoA free check without a key: format, typos, throwaway domains and mail servers. It never checks the mailbox.
create_agent_accountNo key yet? Gets the agent its own key with 25 free credits and a claim link for you.
get_api_discoveryLinks to the MCP server, API, sign-up page and docs.
AI agent questions
Which AI tools does it work with?
Any client that supports the Model Context Protocol (MCP), including Cursor, Claude Desktop and Claude Code. Clients that connect to remote MCP servers can use the hosted URL with your API key.
Can an agent sign itself up?
Yes. An agent can call the create_agent_account tool (no key needed) or POST /api/auth/agent/register to get its own API key with 25 free credits, straight away. A person then opens the claim link to take over the account, which tops it up to the normal 300 free checks a month.
What does a check cost?
One credit per address, the same as the API. Unknown results are free, and credits you buy never expire.
Does verifying an address send an email?
No. BounceLayer asks the mail server whether the mailbox exists. Nothing lands in anyone's inbox.
Why does my agent need a plain-English reason?
Each result includes an explanation, such as "The mail server said this mailbox doesn't exist (550).", so the agent can tell the user why an address was rejected instead of just saying "invalid".
Where can an agent find the docs?
At bouncelayer.com/llms.txt, the OpenAPI spec at /openapi.json, and the MCP discovery file at /.well-known/mcp.json.
Give your agent a real answer
300 free checks every month. Unknown results are free, and credits you buy never expire.