# Bouncer — MCP server on mcp.ai
> Connect your Bouncer account and use 10 tools for email straight from your AI agent. Connect with your own API key. Bouncer is an email verification and validation service that helps ensure email deliverability by verifying email addresses through real-time and batch processing APIs.

By: mcp.ai · official
Page: https://mcp.ai/bouncer

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_bouncer?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/bouncer/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/bouncer/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/bouncer/skill.md
Postman collection (v2.1): https://mcp.ai/bouncer/postman.json

## Tools
- bouncer_check_toxicity_list_job_status(id: string) — Tool to check the status of a specific toxicity list job. Use after creating a toxicity list job to poll its status until completion.
- bouncer_create_batch_request(items: object[], callback?: string) — Initiates an asynchronous batch email verification request. Use when you have multiple emails to verify. Returns a batch ID for tracking - use BOUNCER_GET_BATCH_RESULTS to retrieve verification result
- bouncer_create_toxicity_list_job(emails: string[]) — Tool to create a toxicity analysis job for a list of email addresses. Use when you need to batch-process toxicity checks for multiple emails at once.
- bouncer_delete_batch_request(batch_id: string) — Deletes a batch email verification request and all associated emails and results. Use when you need to permanently remove batch data. This operation is idempotent - calling it multiple times on the sa
- bouncer_delete_toxicity_list_job(id: string) — Tool to delete a specific toxicity list job. Use when you need to remove a completed or unwanted toxicity analysis job after confirming its ID.
- bouncer_finish_batch(batch_id: string) — Tool to mark a batch verification process as finished early. Use when you need to stop batch processing before all emails are verified and reclaim credits for unprocessed emails. IMPORTANT: The batch 
- bouncer_get_batch_results(batch_id: string, download?: string) — Tool to retrieve the results of a batch verification process. Use after submitting a batch to fetch all processed email verification outcomes. Note: If the batch is still processing, the API will retu
- bouncer_get_credits() — Tool to retrieve the current credit balance for the account. Use when you need to check available credits before performing verification operations.
- bouncer_verify_domain(domain: string) — Tool to verify the validity and configuration of a domain. Use when you need to confirm the domain's MX records and catch-all behavior.
- bouncer_verify_email(email: string, timeout?: integer) — Tool to verify a single email address in real-time. Use when validating email entry form inputs instantly.

## Example prompts
- "What can I do in Bouncer?"
- "Show me a summary of my Bouncer account"

## Links
Docs: https://mcp.ai/docs/mcps/bouncer
Website: https://mcp.ai/mcps/bouncer