# NeverBounce — how to use (mcp.ai)

Connect your NeverBounce account and use 12 tools for email straight from your AI agent. Connect with your own API key. NeverBounce provides email verification services to ensure the validity of email addresses, enhancing deliverability and reducing bounce rates.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/neverbounce/account/info` — Tool to get account information including credits, job counts, and usage statistics. Use when retrieving NeverBounce account summary after authentication.
- `POST https://api.mcp.ai/api/neverbounce/confirm/poe` — Tool to confirm proof of email ownership (POE) from the JavaScript widget. Use when verifying server-side that a user confirmed their email through the widget.
  - body: { email: string, result: string, transaction_id: string, confirmation_token: string }
- `POST https://api.mcp.ai/api/neverbounce/jobs/create` — Tool to create a new bulk verification job with parsing, sampling, and callback options. Use for asynchronous list verification with advanced control.
  - body: { input: string|string|integer|number|boolean[]|object[], filename?: string, auto_parse?: boolean, auto_start?: boolean, run_sample?: boolean, callback_url?: string, input_location: string, callback_headers?: object, request_meta_data?: object }
- `POST https://api.mcp.ai/api/neverbounce/jobs/delete` — Tool to permanently delete a job and its results. Use when you need to irreversibly remove a bulk verification job. This delete is irreversible.
  - body: { job_id: integer }
- `POST https://api.mcp.ai/api/neverbounce/jobs/download/get` — Tool to download job results as a CSV file via GET. Use after job completion to retrieve segmented or enriched CSV output.
  - body: { tld?: integer, addr?: integer, fqdn?: integer, host?: integer, alias?: integer, domain?: integer, job_id: integer, valids?: integer, network?: integer, invalids?: integer, unknowns?: integer, catchalls?: integer, subdomain?: integer, bad_syntax?: integer, disposables?: integer, email_status?: integer, has_dns_info?: integer, role_account?: integer, line_feed_type?: string, free_email_host?: integer, has_mail_server?: integer, only_bad_syntax?: integer, only_duplicates?: integer, email_status_int?: integer, include_duplicates?: integer, binary_operators_type?: string, mail_server_reachable?: integer }
- `POST https://api.mcp.ai/api/neverbounce/jobs/results` — Tool to retrieve paginated results for a completed job, including original data and verification outcomes. Use after confirming job completion; avoid aggressive polling as repeated calls before comple
  - body: { page?: integer, job_id: integer, items_per_page?: integer }
- `POST https://api.mcp.ai/api/neverbounce/jobs/start` — Tool to start a parsed job when auto_start is disabled. Use when you need to manually initiate a job that was created with auto_start=false.
  - body: { job_id: integer, run_sample?: boolean }
- `POST https://api.mcp.ai/api/neverbounce/jobs/status` — Tool to get the status and progress of a bulk verification job. Use when
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/neverbounce/parse/job` — Tool to parse a job created with auto_parse disabled. Use when you need to manually parse a job. Cannot reparse once parsed.
  - body: { job_id: integer, auto_start?: boolean }
- `POST https://api.mcp.ai/api/neverbounce/search/jobs` — Tool to search and list bulk verification jobs in your account with pagination and filtering. Use when retrieving jobs by id, filename, or status, or when listing all jobs with pagination.
  - body: { page?: integer, job_id?: integer, filename?: string, job_status?: string, items_per_page?: integer }
- `POST https://api.mcp.ai/api/neverbounce/single/check` — Tool to verify a single email address and gather additional information. Use when you need real-time validation at the point of entry.
  - body: { email: string, timeout?: integer, request_meta_data?: object }
- `POST https://api.mcp.ai/api/neverbounce/widget/send/event` — Tool to send widget form events via the JS widget API. Use when reporting form.load or form.completion events after user interactions with your form.
  - body: { event: string }

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

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