# Emaillistverify — how to use (mcp.ai)

Connect your Emaillistverify account and use 12 tools for email straight from your AI agent. Connect with your own API key. EmailListVerify is a service that provides email verification and validation to ensure email lists are clean and deliverable.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/emaillistverify/check/blacklists` — Tool to check an IP address (IPv4/IPv6) or domain against multiple DNS-based blacklists (DNSBLs) for spam or malicious activity. Use when you need to verify the reputation of an IP or domain. Rate lim
  - body: { value: string }
- `POST https://api.mcp.ai/api/emaillistverify/check/disposable` — Tool to verify if an email domain is associated with temporary/disposable email addresses. Includes DNS record verification. Use when you need to validate if a domain is disposable before accepting em
  - body: { domain: string }
- `POST https://api.mcp.ai/api/emaillistverify/delete/maillist` — Tool to delete a finished email list. Use when you need to remove a completed verification list. Only lists that have completed verification can be deleted.
  - body: { id: string }
- `POST https://api.mcp.ai/api/emaillistverify/download/maillist` — Tool to download a finished email list with verification results. Supports customizable columns (firstName, lastName, gender, result, etc.) and file format (csv/xlsx). Rate limit: 5 requests/second.
  - body: { id: string, addEsp?: string, format?: string, results?: string, addEmail?: string, addGender?: string, addIsFree?: string, addIsRole?: string, addResult?: string, addLastName?: string, addMxServer?: string, addOriginal?: string, addFirstName?: string, addIsNoReply?: string, addDuplicates?: string, addNoEmailRows?: string, addInternalResult?: string }
- `POST https://api.mcp.ai/api/emaillistverify/find/contact` — Tool to search for a contact's business email address by name and company domain. Returns possible emails with confidence levels (high/medium/low/unknown). Rate limit: 5 requests/second. Credits: 5 (w
  - body: { domain: string, lastName?: string, firstName?: string }
- `POST https://api.mcp.ai/api/emaillistverify/get/api/file/info` — Tool to retrieve progress of an uploaded email list verification. Returns status (errored/waiting/progress/finished) with download URLs when complete.
  - body: { id: string }
- `POST https://api.mcp.ai/api/emaillistverify/get/credits` — Tool to retrieve details about available on-demand and subscription credits. Use when you need to check credit balance before performing verifications. On-demand credits never expire, subscription cre
- `POST https://api.mcp.ai/api/emaillistverify/get/email/job` — Tool to get the status of an asynchronous email verification job. Use when you need to check if a verification job has completed and retrieve its results. Rate limit: 100 requests per second.
  - body: { id: string }
- `POST https://api.mcp.ai/api/emaillistverify/get/maillist/progress` — Tool to retrieve real-time progress updates for an uploaded email list verification. Shows status, completion percentage, and credit usage. Rate limit: 100 requests/second.
  - body: { id: string }
- `POST https://api.mcp.ai/api/emaillistverify/upload/email/list` — Tool to upload an email list file for bulk verification. Accepts .csv, .txt, or .xlsx files (max 100MB, 1M rows). Returns an ID to query verification progress. Rate limit: 5 requests/second.
  - body: { quality?: string, file_contents: object }
- `POST https://api.mcp.ai/api/emaillistverify/verify/single/email` — Tool to verify email deliverability status of a single email address. Returns a plain text status representing deliverability. Rate limit: 10 requests/second. Credits required: 1.
  - body: { email: string }
- `POST https://api.mcp.ai/api/emaillistverify/verify/single/email/detailed` — Tool to verify email deliverability with detailed metadata including MX server info, ESP, first/last name estimation, gender, and role detection. Use when you need comprehensive email validation beyon
  - body: { email: string }

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

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