# Minelead.io — how to use (mcp.ai)

Connect your Minelead.io account and use 10 tools for AI sales tools straight from your AI agent. Connect with your own API key. Minelead.io provides email discovery, verification, enrichment, lead management, buying-intent analysis, and campaign recipient APIs for sales workflows.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/minelead/detect/disposable/email` — Check an email for disposable-address, DNS, format, and spam signals. Minelead does not document this endpoint's credit cost, so callers should treat it as potentially credit-consuming. HTTP 200 appli
  - body: { email: string }
- `POST https://api.mcp.ai/api/minelead/enrich/email` — Enrich one email with professional and social profile information. Minelead charges 2 credits per request. A no-match result is returned with status `not_found`; application errors reported inside HTT
  - body: { name?: string, email: string, company?: string }
- `POST https://api.mcp.ai/api/minelead/find/person/email` — Find a person's professional email from their name and company domain. A found result costs 1 credit; Minelead documents no charge when no email or only bouncing emails are returned. Catch-all domains
  - body: { domain: string, last_name: string, first_name: string }
- `POST https://api.mcp.ai/api/minelead/find/social/profile/emails` — Find emails associated with a YouTube channel or Twitter/X profile URL. Results may be masked and are locally capped by max_emails_to_return; the response reports truncation. Minelead charges 2 credit
  - body: { profile_url: string, max_emails_to_return?: integer }
- `POST https://api.mcp.ai/api/minelead/generate/company/domains` — Generate candidate company domains from keyword and location tags. A successful request costs 1 credit, and returned domains may be masked.
  - body: { tags: string[] }
- `POST https://api.mcp.ai/api/minelead/list/saved/leads` — List leads already saved in the connected Minelead account. Minelead documents no credit cost for this read. The verified no-leads response is returned as an empty list, while application-level errors
- `POST https://api.mcp.ai/api/minelead/list/search/history` — Return up to 25 entries from the connected account's search history. Minelead does not document a credit cost for this read. Use the returned cursor to continue; a verified no-history response marks t
  - body: { cursor?: string }
- `POST https://api.mcp.ai/api/minelead/search/company/emails` — Find known email addresses for a company domain. Results may include masked addresses. A successful standard search costs 1 credit; Deep Search and inline enrichment are not included.
  - body: { domain: string, light_mode?: boolean, max_emails?: integer, generic_only?: boolean }
- `POST https://api.mcp.ai/api/minelead/search/company/emails/batch` — Search 1-8 company domains in one call and return a result for each domain. Results may include masked addresses. Each successful domain search costs 1 credit, so one batch can cost up to 8 credits.
  - body: { domains: string[], light_mode?: boolean, generic_only?: boolean, max_emails_per_domain?: integer }
- `POST https://api.mcp.ai/api/minelead/validate/email` — Validate an email's format, MX records, mailbox result, personal-provider status, and disposability. Minelead charges 1 credit per verification. HTTP 200 may contain an application failure; `catch-all
  - body: { email: string, last_name?: string, first_name?: string }

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

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