LeadEnrich MCP Server

Waterfall lead enrichment for AI agents. Cascades through Apollo, Clearbit, and Hunter to build the most complete lead profile in a single call.

One-click install: Install on MCPize | pip install leadenrich-mcp

LeadEnrich MCP exposes lead and company enrichment through the Model Context Protocol (MCP), so tools like Claude and Cursor can run enrichment workflows directly. Give it an email, domain, or name and it returns a merged profile with field attribution showing which provider contributed each data point.

Quick Connect

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "leadenrich": {
      "url": "http://localhost:8300/mcp"
    }
  }
}

Claude Code

claude mcp add leadenrich --transport http http://localhost:8300/mcp

Tools

| Tool | Description | |------|-------------| | enrich_lead | Full waterfall enrichment for a single lead (email, domain, or name+domain) | | find_email | Discover an email from first name + last name + company domain | | enrich_company | Company firmographic data by domain (industry, size, revenue, etc.) | | enrich_batch | Batch enrich up to 25 leads concurrently | | check_usage | Quota, cost tracking, and remaining lookups | | health_check | Server status, configured providers, and cache stats |

How It Works

LeadEnrich uses a waterfall strategy: each provider fills gaps left by the previous one. When email is known, all providers run concurrently for speed. When only name+domain is provided, Apollo discovers the email first, then Clearbit and Hunter run in parallel.

Input (email / domain / name+domain)
         |
         v
  +-----------+     +-----------+     +----------+
  |   Apollo  | --> |  Clearbit | --> |  Hunter  |
  +-----------+     +-----------+     +----------+
  |  Contact  |     |  Company  |     |  Email   |
  |  Company  |     |  Person   |     |  Verify  |
  |  LinkedIn |     |  Firmo    |     |  Domain  |
  +-----------+     +-----------+     +----------+
         |               |                |
         v               v                v
  +------------------------------------------+
  |        Merged Profile                    |
  |  16+ fields with per-field attribution   |
  |  Confidence score + lookup cost          |
  +------------------------------------------+

Each field in the result includes attribution so you know exactly which provider it came from. No duplicate API calls thanks to built-in caching.

Pricing

| Tier | Cost | Details | |------|------|---------| | Free | $0.00 | 50 lookups/month | | 1 provider hit | $0.05/lookup | Single provider returned data | | 2 providers hit | $0.10/lookup | Two providers contributed fields | | 3 providers hit | $0.15/lookup | Full waterfall, maximum coverage |

Requirements

• Python 3.11+
• pip

Quick Start

git clone https://github.com/carsonlabs/leadenrich-mcp.git
cd leadenrich-mcp
pip install -r requirements.txt
python main.py

MCP endpoint:

• http://localhost:8300/mcp

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | APOLLO_API_KEY | Apollo.io API key | No | | CLEARBIT_API_KEY | Clearbit API key | No | | HUNTER_API_KEY | Hunter.io API key | No | | LEADENRICH_API_KEY | Client auth key for usage metering | No |

... View full README on GitHub