# Bouncify — how to use (mcp.ai)

Connect your Bouncify account and use 7 tools for marketing straight from your AI agent. Connect with your own API key. Bouncify verifies individual email addresses and bulk email lists and reports the account's remaining verification credits.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bouncify?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. `bouncify_create_bulk_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bouncify`
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/bouncify/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bouncify/create/bulk/list` — Submit at least two email records for asynchronous bulk-job preparation without starting verification or consuming credits. Poll Get Bulk Job Status until the job is ready before starting verification
  - body: { emails: object[] }
- `POST https://api.mcp.ai/api/bouncify/download/bulk/results` — Download selected result classes from a completed bulk-verification job as a CSV file.
  - body: { job_id: string, filter_results?: string[] }
- `POST https://api.mcp.ai/api/bouncify/get/bulk/job/status` — Return a bulk job's preparation or verification state, progress, analysis, and result counts. Treat status as authoritative: a failed job can still have success=true.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/bouncify/get/credit/balance` — Return the connected Bouncify account's remaining verification credits without consuming a credit.
- `POST https://api.mcp.ai/api/bouncify/request/bulk/list/deletion` — Permanently request deletion of a bulk list and its results. This operation is irreversible. Bouncify acknowledges an asynchronous or delayed deletion, so success means the request was accepted, not t
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/bouncify/start/bulk/verification` — Irreversibly start verification for a prepared bulk list. This consumes one verification credit per email and, after a successful start, cannot be paused, stopped, cancelled, or restarted. Check that 
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/bouncify/verify/email` — Verify one email address in real time. Every successful API call consumes one verification credit, including an address that Bouncify classifies as invalid syntax.
  - body: { email: string, timeout_ms?: integer }

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

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