BounceLayer

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_key

Let 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_email

    Check one address. Returns a status and a plain-English reason.

  • submit_bulk_verification

    Check a whole list as a background job.

  • get_bulk_job

    Get a list job's progress and results.

  • list_bulk_jobs

    See recent list jobs.

  • cancel_bulk_job

    Stop a list job that's still running.

  • get_credit_balance

    See how many credits are left.

  • verify_email_demo

    A free check without a key: format, typos, throwaway domains and mail servers. It never checks the mailbox.

  • create_agent_account

    No key yet? Gets the agent its own key with 25 free credits and a claim link for you.

  • get_api_discovery

    Links 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.