# Clearout — how to use (mcp.ai)

Connect your Clearout account and use 21 tools for email straight from your AI agent. Connect with your own API key. Clearout offers AI-powered email validation, email finder, and prospecting services to enhance email deliverability and lead generation.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/clearout/autocomplete/company/to/domain` — Tool to autocomplete company names to probable domains with confidence scores. Use after obtaining a company name or URL to get suggestions.
  - body: { query: string }
- `POST https://api.mcp.ai/api/clearout/business/account/verify` — Tool to check if an email belongs to a business/work account. Use when validating corporate emails before onboarding.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/catch/all/verify` — Tool to check if an email domain is catch-all. Use after confirming email validity.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/disposable/verify` — Tool to check if an email is from a disposable provider. Use after acquiring an email address.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/domain/find/mx` — Tool to retrieve MX records for a domain in priority order. Use when you need to find a domain's mail servers (e.g., for email routing setup).
  - body: { domain: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/domain/find/whois` — Tool to fetch WHOIS record for a domain. Use when you need WHOIS data for a domain.
  - body: { domain: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/email/finder/bulk` — Tool to upload a CSV or XLSX contacts file for bulk email finding. Use when you need to find emails for a list of contacts in bulk.
  - body: { file: object, ignore_duplicate_file?: string }
- `POST https://api.mcp.ai/api/clearout/email/finder/bulk/cancel` — Tool to cancel a running bulk email finder job. Use when you need to stop an in-progress list scan before completion.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/clearout/email/finder/bulk/result/download` — Tool to generate a bulk email finder result download URL. Use after confirming bulk job completion to retrieve the result file link.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/clearout/email/verify/bulk` — Tool to upload a CSV or XLSX file for bulk email verification. Use when you have a list of emails to verify in bulk.
  - body: { file: object, optimize?: string, ignore_duplicate_file?: string }
- `POST https://api.mcp.ai/api/clearout/email/verify/bulk/cancel` — Cancel an in-progress bulk email verification job. Use this to stop a running verification before it completes, saving credits for unprocessed emails. The job must be in a cancellable state (not alrea
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/clearout/email/verify/bulk/progress/status` — Tool to retrieve progress for a bulk email verification job. Use after initiating a bulk verification to poll its state and percent complete.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/clearout/email/verify/bulk/result/download` — Tool to obtain a temporary URL for bulk email verification results. Use after completing a bulk verification job to download the results file.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/clearout/email/verify/get/credits` — Tool to fetch available email verification credits. Use when checking remaining credits before performing email verifications.
- `POST https://api.mcp.ai/api/clearout/email/verify/instant` — Tool to instantly verify a single email address. Use when you need real-time validation before processing an email.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/free/account/verify` — Tool to detect if an email is from a free email service provider. Use after confirming the email format.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/gibberish/account/verify` — Tool to verify if an email address is gibberish. Use when filtering out nonsensical or invalid-looking emails.
  - body: { email: string, timeout?: integer }
- `POST https://api.mcp.ai/api/clearout/reverse/lookup/find/company/via/domain` — Find company information (name, logo, LinkedIn URL, address) by looking up its domain name. Returns company profile data if found, or an error with code 5025 if no profile exists for the domain.
  - body: { name: string }
- `POST https://api.mcp.ai/api/clearout/reverse/lookup/find/person/via/email` — Tool to retrieve a person’s profile from an email address. Use when you want to enrich a valid email with associated person details.
  - body: { email_address: string }
- `POST https://api.mcp.ai/api/clearout/reverse/lookup/find/person/via/linked/in` — Tool to discover person information via a LinkedIn profile URL. Use when you need to retrieve person’s profile details from a LinkedIn URL.
  - body: { url: string }
- `POST https://api.mcp.ai/api/clearout/role/account/verify` — Tool to determine if an email is a role-based account. Use when identifying group mailboxes (e.g., support@) before sending targeted communications.
  - body: { email: string, timeout?: integer }

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

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