# Zerobounce — how to use (mcp.ai)

Connect your Zerobounce account and use 20 tools for email straight from your AI agent. Connect with your own API key. ZeroBounce is an email validation and deliverability platform that helps businesses improve email marketing performance by identifying and removing invalid or risky email addresses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zerobounce?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zerobounce_activity_data`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zerobounce`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zerobounce/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zerobounce/activity/data` — Tool to get activity data (opens, clicks, etc.) for a given email. Use after confirming the email address to gauge engagement recency.
  - body: { email: string }
- `POST https://api.mcp.ai/api/zerobounce/ai/scoring/single` — Tool to score a single email address using ZeroBounce AI. Use when you need real-time email lead quality feedback before outreach. Example prompt: "Score the email mark@gmail.com."
  - body: { email: string }
- `POST https://api.mcp.ai/api/zerobounce/allow/block/list` — Tool to manage allowlist and blocklist for email validation. Use when you need to programmatically add or modify custom filters before validating emails.
  - body: { rule: string, value: string, target: string }
- `POST https://api.mcp.ai/api/zerobounce/batch/validate/emails` — Tool to validate a batch of email addresses in real time. Use when you need to validate up to 200 emails at once with optional activity data.
  - body: { api_key?: string, timeout?: integer, email_batch: object[], verify_plus?: boolean, activity_data?: boolean }
- `POST https://api.mcp.ai/api/zerobounce/delete/ai/scoring/file` — Tool to remove a completed AI scoring file from ZeroBounce servers. Use when the file status is 'Complete' and you need to remove it.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/delete/file` — Tool to delete a file that was submitted for bulk validation. Use when file status is 'Complete'.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/domain/search/file/status` — Tool to get the processing status of a file submitted for bulk domain search. Use after submitting the file to poll status.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/domain/search/get/file` — Tool to download the results file for a completed bulk domain search job. Use when you have the file_id and the job is complete.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/domain/search/send/file` — Tool to upload a file for bulk domain search. Use when you have many domains in a CSV/TXT and need to lookup their details in bulk.
  - body: { file: object, domain_column: integer, has_header_row?: boolean }
- `POST https://api.mcp.ai/api/zerobounce/domain/search/single` — Tool to identify common email address formats for a given domain. Use when you need to guess email patterns for a company based on its domain.
  - body: { domain?: string, last_name?: string, first_name?: string, middle_name?: string, company_name?: string }
- `POST https://api.mcp.ai/api/zerobounce/email/finder/delete/file` — Tool to delete a file that was submitted for bulk email finding. Use when the file processing status is 'Complete' and you need to remove it.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/email/finder/file/status` — Tool to get the processing status of a file submitted for bulk email finding. Use when you need to poll the progress of a bulk email-finder file upload.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/email/finder/send/file` — Tool to upload a file for bulk email finding. Use when you have lists of names and domains to find emails in bulk via CSV/TXT upload.
  - body: { file: string, file_name: string, domain_column: integer, has_header_row?: boolean, full_name_column?: integer, last_name_column?: integer, first_name_column?: integer, middle_name_column?: integer }
- `POST https://api.mcp.ai/api/zerobounce/get/api/usage` — Tool to retrieve API usage statistics for a given period. Use when you need usage metrics between two dates.
  - body: { end_date: string, start_date: string }
- `POST https://api.mcp.ai/api/zerobounce/get/credit/balance` — Tool to retrieve your current ZeroBounce email validation credit balance. Use when you need to monitor remaining credits to avoid service interruptions.
- `POST https://api.mcp.ai/api/zerobounce/get/email/finder/file` — Tool to download the results file for a completed bulk email finder job. Use when you have the file_id and the job is complete.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/zerobounce/list/evaluator` — Tool to evaluate the quality of an email list. Use when you have a list of emails and need a quick health check before full validation.
  - body: { file: string, file_name: string, email_address_column: integer }
- `POST https://api.mcp.ai/api/zerobounce/list/filters` — Tool to retrieve all email addresses and domains in your allowlist and blocklist filters. Use when you need to view or audit current filter rules before validation.
- `POST https://api.mcp.ai/api/zerobounce/send/file` — Tool to upload a file for bulk email validation. Use when you need to validate large lists of emails via CSV or TXT file.
  - body: { file: string, file_name: string, return_url?: string, gender_column?: integer, has_header_row?: boolean, last_name_column?: integer, remove_duplicate?: boolean, first_name_column?: integer, ip_address_column?: integer, email_address_column: integer }
- `POST https://api.mcp.ai/api/zerobounce/validate/email` — Tool to validate a single email address in real time. Use when you need to confirm deliverability and domain details before sending emails. Each call consumes API credits; set `credits_info: true` to 
  - body: { email: string, ip_address?: string, credits_info?: boolean }

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

## More
- Page: https://mcp.ai/zerobounce
- Agent spec (llms.txt): https://mcp.ai/zerobounce/llms.txt
- Postman collection: https://mcp.ai/zerobounce/postman.json