# Bettercontact — how to use (mcp.ai)

Connect your Bettercontact account and use 5 tools for contact management straight from your AI agent. Connect with your own API key. Smart Waterfall Email & Phone Finder for contact enrichment and lead generation.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/bettercontact/check/credits/balance` — Tool to check the remaining credits balance for a BetterContact account. Use when you need to verify available credits before making API requests that consume credits.
- `POST https://api.mcp.ai/api/bettercontact/create/lead/finder/search` — Tool to create a new Lead Finder search to discover leads based on company and people criteria. Use when you need to find prospects matching specific job titles, departments, seniority, company size, 
  - body: { filters: object, webhook?: string, max_leads?: integer }
- `POST https://api.mcp.ai/api/bettercontact/enrich/leads` — Tool to create a lead enrichment request for work emails and direct phone numbers. Uses waterfall enrichment across multiple data providers for higher accuracy. Supports batches of 1-100 leads.
  - body: { data: object[], webhook?: string, process_flow?: string, enrich_phone_number: boolean, enrich_email_address: boolean }
- `POST https://api.mcp.ai/api/bettercontact/get/enrichment/results` — Tool to retrieve enrichment results for a specific request ID. Use when you need to check the status and get enriched lead data including email addresses, contact information, and summary statistics f
  - body: { request_id: string }
- `POST https://api.mcp.ai/api/bettercontact/get/lead/finder/results` — Tool to retrieve results from a submitted Lead Finder search. Returns comprehensive lead and company data including contact information, LinkedIn profiles, job titles, company details, and enrichment 
  - body: { request_id: string }

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

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