# ApexVerify — how to use (mcp.ai)

Connect your ApexVerify account and use 10 tools for contact management straight from your AI agent. Connect with your own API key. ApexVerify validates and normalizes email addresses and phone numbers individually or in batches to improve contact-data quality.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/apexverify/delete/batch` — Permanently delete one ApexVerify batch by its exact UUID. Deletion is irreversible and unavailable while the batch is processing; verify the target batch first and deliberately set confirm_deletion=t
  - body: { batch_uuid: string, confirm_deletion: boolean }
- `POST https://api.mcp.ai/api/apexverify/export/batch/results` — Export a completed batch as structured JSON for analysis or as a downloadable XLSX workbook. This reads existing results and does not consume verification credits.
  - body: { format?: string, batch_uuid: string, include_details?: boolean, include_statistics?: boolean }
- `POST https://api.mcp.ai/api/apexverify/get/account/credits` — Return the connected ApexVerify account's available email and phone verification credit balances. Use this before any credit-consuming verification.
- `POST https://api.mcp.ai/api/apexverify/get/batch/details` — Get an ApexVerify batch's status, metadata, parsed-content counts, estimated verification cost, parameters, and final statistics. Repeat this call to monitor preparation or verification.
  - body: { batch_uuid: string }
- `POST https://api.mcp.ai/api/apexverify/launch/batch/verification` — Launch paid verification for a prepared batch. This consumes the batch's estimated net email or phone credits and can fail when credits are insufficient. First inspect Get Batch Details and Get Accoun
  - body: { batch_uuid: string, confirm_credit_spend: boolean }
- `POST https://api.mcp.ai/api/apexverify/list/batches` — List verification batches, optionally restricted by creation time, one offset-controlled page at a time.
  - body: { limit?: integer, offset?: integer, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/apexverify/normalize/email/or/phone/file` — Normalize email addresses or phone numbers from a line-delimited TXT file without performing verification or consuming verification credits.
  - body: { file: object, type: string, target_country: string }
- `POST https://api.mcp.ai/api/apexverify/prepare/batch` — Start or repeat asynchronous parsing, deduplication, format cleanup, and verification-cost calculation for an uploaded batch. This idempotent action does not launch paid verification. Poll Get Batch D
  - body: { batch_uuid: string }
- `POST https://api.mcp.ai/api/apexverify/upload/batch` — Create an ApexVerify verification batch from a line-delimited TXT file. Uploading does not consume verification credits; verification starts only when the batch is launched separately.
  - body: { file: object, name: string, type: string, description?: string, target_country: string, target_audience?: string, remove_duplicate?: boolean, target_objective?: string, use_global_cache?: boolean, use_account_cache?: boolean, target_market_industry?: string, max_global_cache_backoff?: integer, max_account_cache_backoff?: integer, remove_wrong_email_format?: boolean, remove_wrong_phone_format?: boolean }
- `POST https://api.mcp.ai/api/apexverify/verify/email/or/phone` — Verify one email address or phone number in real time. This consumes the corresponding prepaid verification credit; cache hits may receive a partial refund. Check account credits first and deliberatel
  - body: { type: string, unit: string, target_country: string, target_audience?: string, target_objective?: string, use_global_cache?: boolean, use_account_cache?: boolean, confirm_credit_usage: boolean, target_market_industry?: string, max_global_cache_backoff?: integer, max_account_cache_backoff?: integer }

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

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