# MailerCheck — how to use (mcp.ai)

Connect your MailerCheck account and use 9 tools for email straight from your AI agent. Connect with your own API key. MailerCheck verifies individual email addresses and email lists, reports verification results, and tracks account credit balances.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/mailercheck/create/verification/list` — Create a MailerCheck verification list by ingesting a name and email-address array. Creating a one-address list did not reduce the account credit balance during live probing. This action does not invo
  - body: { name: string, emails: string[] }
- `POST https://api.mcp.ai/api/mailercheck/delete/verification/list` — Permanently and irreversibly delete a MailerCheck verification list by ID. Use only when the caller explicitly intends to remove the list.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/mailercheck/get/credit/balance` — Return the current MailerCheck verification-credit balance. Use this before VERIFY_EMAIL or START_LIST_VERIFICATION when cost matters.
- `POST https://api.mcp.ai/api/mailercheck/get/current/account` — Return the connected MailerCheck user and account identity. Use this to confirm which user and account the API token represents.
- `POST https://api.mcp.ai/api/mailercheck/get/verification/list` — Return one verification list, including its status, item count, verification timing, and aggregate result statistics.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/mailercheck/list/verification/lists` — Return one page of verification lists for the connected MailerCheck account, with an opaque cursor when another provider-controlled page exists.
  - body: { next_cursor?: string }
- `POST https://api.mcp.ai/api/mailercheck/list/verification/results` — Return one page of email-level results for a verification list, optionally filtered by classification. The success envelope and pagination behavior are based on MailerCheck documentation and were not 
  - body: { limit?: integer, result?: string, list_id: integer, next_cursor?: string }
- `POST https://api.mcp.ai/api/mailercheck/start/list/verification` — Irreversibly start verification of every address in a MailerCheck list. A successful call spends one verification credit per address. Before calling, use GET_VERIFICATION_LIST to inspect the list coun
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/mailercheck/verify/email` — Consumes exactly one MailerCheck verification credit on every successful call. Synchronously verify one email address and return its classification; check GET_CREDIT_BALANCE first if cost matters.
  - body: { email: string }

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

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