# Verifiedemail — how to use (mcp.ai)

Connect your Verifiedemail account and use 9 tools for email straight from your AI agent. Connect with your own API key. VerifiedEmail offers real-time email verification and bulk email list cleaning services to ensure the accuracy and deliverability of email communications.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/verifiedemail/check/credits` — Tool to retrieve the remaining verification credits. Call before VERIFIEDEMAIL_VERIFY_EMAIL operations—especially in bulk or repeated workflows—as VERIFIEDEMAIL_VERIFY_EMAIL fails immediately when cre
- `POST https://api.mcp.ai/api/verifiedemail/check/file/status` — Tool to check the status of a previously uploaded file. Use after uploading a file when polling for verification progress.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/verifiedemail/get/entitlements` — Tool to retrieve information about available credits across different entitlement types. Use when you need to check credit availability before performing operations that consume credits.
- `POST https://api.mcp.ai/api/verifiedemail/get/shared/credentials` — Tool to retrieve a list of shared credential IDs. Use when you need to fetch all credentials shared to your account after authentication.
- `POST https://api.mcp.ai/api/verifiedemail/get1/click/user/data` — Tool to retrieve data for a user who has completed a 1-Click Signup flow. Use after you have the identityUuid to fetch the verified user's full profile.
  - body: { identityUuid: string }
- `POST https://api.mcp.ai/api/verifiedemail/list/downloads` — Tool to get a list of previously created download requests. Use when you need to retrieve information about download requests that have been created for verification results.
  - body: { limit?: string, offset?: string, sortField?: string, sortOrder?: string }
- `POST https://api.mcp.ai/api/verifiedemail/list/lists` — Tool to get all email lists in your account. Use when you need to retrieve and view all verification lists with optional pagination and sorting.
  - body: { limit?: string, offset?: string, sortField?: string, sortOrder?: string }
- `POST https://api.mcp.ai/api/verifiedemail/post1/click/credentials/update` — Tool to update 1-Click credentials. Use after obtaining a 1-Click session uuid when you need to update user-provided credential values in a non-hosted or trusted flow.
  - body: { uuid: string, credentials: object }
- `POST https://api.mcp.ai/api/verifiedemail/verify/email` — Tool to verify the deliverability and validity of an email address. Use when you need to confirm if an email can receive mail by checking server existence, mailbox status, and more. For bulk use, call
  - body: { email: string }

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

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