# Fullenrich — how to use (mcp.ai)

Connect your Fullenrich account and use 9 tools for contact management straight from your AI agent. Connect with your own API key. FullEnrich is a B2B email and phone waterfall enrichment platform that aggregates contact information from over 15 premium vendors to find the emails and phone numbers of leads.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/fullenrich/create/contact/data/list` — Tool to create a list of contact data entries. Use when preparing the 'datas' payload for bulk enrichment; validates each contact's composition and returns a JSON-ready list.
  - body: { contacts: object[] }
- `POST https://api.mcp.ai/api/fullenrich/get/current/credit/balance` — Tool to retrieve current workspace credit balance. Use after authenticating your API key.
- `POST https://api.mcp.ai/api/fullenrich/get/enrichment/result` — Tool to retrieve results of a bulk enrichment by enrichment ID. Use after submitting a bulk enrichment job to check its status and get enriched data.
  - body: { forceResults?: boolean, enrichment_id: string }
- `POST https://api.mcp.ai/api/fullenrich/get/reverse/email/result` — Tool to retrieve results from a reverse email lookup operation using reverse email ID. Use after submitting a reverse email lookup to check its status and get contact data.
  - body: { reverse_email_id: string }
- `POST https://api.mcp.ai/api/fullenrich/reverse/email/lookup` — Tool to perform bulk reverse email lookup to retrieve full person and company profile from work or personal email addresses. Use when you have email addresses and need to enrich them with complete con
  - body: { data: object[], name: string, webhook_url?: string }
- `POST https://api.mcp.ai/api/fullenrich/search/company` — Tool to search for companies based on filters including name, domain, industry, type, headquarters location, headcount, and founded year. Multiple filters within the same field are combined with OR lo
  - body: { limit?: integer, names?: string[], types?: string[], offset?: integer, domains?: string[], keywords?: string[], headcounts?: string[], industries?: string[], specialties?: string[], search_after?: string, founded_years?: string[], linkedin_urls?: string[], headquarters_locations?: string[] }
- `POST https://api.mcp.ai/api/fullenrich/search/people` — Tool to search for people based on filters including company, location, skills, position titles, and seniority levels. Multiple filters within the same field are combined with OR logic. Use when you n
  - body: { limit?: integer, offset?: integer, search_after?: string, person_skills?: object[], person_locations?: object[], current_company_names?: object[], current_company_domains?: object[], current_position_titles?: object[], current_company_headcounts?: object[], current_company_industries?: object[], current_position_seniority_level?: object[] }
- `POST https://api.mcp.ai/api/fullenrich/start/bulk/enrichment` — Tool to start a bulk enrichment job. Use when you have up to 100 contacts prepared and need batch enrichment. Use after confirming contact data.
  - body: { name: string, datas: object[], checkDomain?: boolean, webhook_url?: string, checkLinkedinUrl?: boolean }
- `POST https://api.mcp.ai/api/fullenrich/verify/api/key` — Tool to check if your API key is valid and return the associated workspace ID. Use when you need to verify API key validity before performing other operations.

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

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