{
  "markdown": "<!-- mcp-name: io.github.carsonlabs/leadenrich-mcp -->\n\n# LeadEnrich MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![PyPI](https://img.shields.io/pypi/v/leadenrich-mcp)](https://pypi.org/project/leadenrich-mcp/)\n[![MCP](https://img.shields.io/badge/MCP-compatible-6366f1.svg)](https://modelcontextprotocol.io)\n[![MCPize](https://img.shields.io/badge/MCPize-Install-a855f7)](https://mcpize.com/mcp/leadenrich-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)\n\nWaterfall lead enrichment for AI agents. Cascades through Apollo, Clearbit, and Hunter to build the most complete lead profile in a single call.\n\n> **One-click install:** [Install on MCPize](https://mcpize.com/mcp/leadenrich-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) | `pip install leadenrich-mcp`\n\nLeadEnrich 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.\n\n## Quick Connect\n\n### 1. Install and start the server\n\n```bash\npip install leadenrich-mcp\nleadenrich-mcp\n```\n\nThe server starts on `http://localhost:8300/mcp` by default.\n\n### 2a. Connect from Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadenrich\": {\n      \"url\": \"http://localhost:8300/mcp\"\n    }\n  }\n}\n```\n\n### 2b. Connect from Claude Code\n\n```bash\nclaude mcp add leadenrich --transport http http://localhost:8300/mcp\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `enrich_lead` | Full waterfall enrichment for a single lead (email, domain, or name+domain) |\n| `find_email` | Discover an email from first name + last name + company domain |\n| `enrich_company` | Company firmographic data by domain (industry, size, revenue, etc.) |\n| `enrich_batch` | Batch enrich up to 25 leads concurrently |\n| `check_usage` | Quota, cost tracking, and remaining lookups |\n| `health_check` | Server status, configured providers, and cache stats |\n\n## How It Works\n\nLeadEnrich 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.\n\n```\nInput (email / domain / name+domain)\n         |\n         v\n  +-----------+     +-----------+     +----------+\n  |   Apollo  | --> |  Clearbit | --> |  Hunter  |\n  +-----------+     +-----------+     +----------+\n  |  Contact  |     |  Company  |     |  Email   |\n  |  Company  |     |  Person   |     |  Verify  |\n  |  LinkedIn |     |  Firmo    |     |  Domain  |\n  +-----------+     +-----------+     +----------+\n         |               |                |\n         v               v                v\n  +------------------------------------------+\n  |        Merged Profile                    |\n  |  16+ fields with per-field attribution   |\n  |  Confidence score + lookup cost          |\n  +------------------------------------------+\n```\n\nEach field in the result includes attribution so you know exactly which provider it came from. No duplicate API calls thanks to built-in caching.\n\n## Pricing\n\n| Tier | Cost | Details |\n|------|------|---------|\n| Free | $0.00 | 50 lookups/month |\n| 1 provider hit | $0.05/lookup | Single provider returned data |\n| 2 providers hit | $0.10/lookup | Two providers contributed fields |\n| 3 providers hit | $0.15/lookup | Full waterfall, maximum coverage |\n\n## Requirements\n\n- Python 3.11+\n- `pip`\n\n## Quick Start\n\n```bash\ngit clone https://github.com/carsonlabs/leadenrich-mcp.git\ncd leadenrich-mcp\npip install -r requirements.txt\npython main.py\n```\n\nMCP endpoint:\n\n- `http://localhost:8300/mcp`\n\n## Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `APOLLO_API_KEY` | Apollo.io API key | No |\n| `CLEARBIT_API_KEY` | Clearbit API key | No |\n| `HUNTER_API_KEY` | Hunter.io API key | No |\n| `LEADENRICH_API_KEY` | Client auth key for usage metering | No |\n| `LEADENRICH_FREE_TIER_LIMIT` | Free tier limit (default: 50) | No |\n| `PORT` | Server port (default: 8300) | No |\n\nAll provider keys are optional. The server uses whichever providers are configured and skips the rest.\n\nExample:\n\n```bash\nexport APOLLO_API_KEY=\"your-apollo-key\"\nexport CLEARBIT_API_KEY=\"your-clearbit-key\"\nexport HUNTER_API_KEY=\"your-hunter-key\"\npython main.py\n```\n\n## Running Options\n\nRun directly:\n\n```bash\npython main.py\n```\n\nRun via FastMCP CLI:\n\n```bash\nfastmcp run main.py --transport streamable-http --port 8300\n```\n\n## Tool Details\n\n### `enrich_lead`\n\nInputs:\n\n- `email` (optional): Contact email address (best identifier)\n- `domain` (optional): Company domain (e.g. \"stripe.com\")\n- `first_name` / `last_name` (optional): Contact name (combine with domain)\n- `providers` (optional): Limit which providers to use\n- `api_key` (optional): Your LeadEnrich API key\n\nReturns merged lead profile with field attribution, confidence score, and lookup cost.\n\n### `find_email`\n\nInputs:\n\n- `first_name` (required): Contact's first name\n- `last_name` (required): Contact's last name\n- `domain` (required): Company domain\n\nReturns discovered email with confidence score and verification status.\n\n### `enrich_company`\n\nInput:\n\n- `domain` (required): Company domain\n\nReturns company-level firmographic data: industry, size, revenue, description, location.\n\n### `enrich_batch`\n\nInputs:\n\n- `leads` (required): List of lead objects (max 25), each with optional email/domain/name\n- `providers` (optional): Limit which providers to use\n- `api_key` (optional): Your LeadEnrich API key\n\nReturns list of enriched profiles with batch summary.\n\n### `check_usage`\n\nInput:\n\n- `api_key` (optional): Your LeadEnrich API key\n\nReturns usage stats: lookup count, cost, tier, remaining quota, and cache stats.\n\n### `health_check`\n\nNo input. Returns server status, configured providers, cache stats, and version info.\n\n## Try It\n\n```bash\nfastmcp list-tools main.py\nfastmcp call-tool main.py health_check '{}'\nfastmcp call-tool main.py enrich_lead '{\"email\":\"jane@stripe.com\"}'\nfastmcp call-tool main.py find_email '{\"first_name\":\"Jane\",\"last_name\":\"Smith\",\"domain\":\"stripe.com\"}'\nfastmcp call-tool main.py enrich_company '{\"domain\":\"stripe.com\"}'\n```\n\n## Deployment\n\n### Smithery\n\nThis repo includes `smithery.yaml` for [Smithery](https://smithery.ai/) deployment.\n\n1. Push repository to GitHub\n2. Create/add server in Smithery\n3. Point Smithery to this repository\n\n### Docker / Hosting Platforms\n\nA `Dockerfile` is included for Railway, Fly.io, and other container hosts.\n\n```bash\n# Railway\nrailway up\n\n# Fly.io\nfly launch\nfly deploy\n```\n\nSet your provider API keys in your host environment.\n\n## Architecture\n\n```text\nAgent (Claude, Cursor, etc.)\n  -> MCP\nLeadEnrich MCP Server (this repo)\n  -> Apollo API    (contact + company data)\n  -> Clearbit API  (person + firmographic data)\n  -> Hunter API    (email finding + verification)\n```\n\nThis server is a translation layer between MCP tool calls and multiple enrichment provider APIs, with built-in caching, usage metering, and waterfall merge logic.\n\n## Free vs Pro\n\n| Tool | Free | Pro ($29/mo) |\n|------|------|-------------|\n| `enrich_lead` | Yes (Hunter only) | Yes (full waterfall: Apollo + Clearbit + Hunter) |\n| `check_usage` | Yes | Yes |\n| `health_check` | Yes | Yes |\n| `find_email` | - | Yes |\n| `enrich_company` | - | Yes |\n| `enrich_batch` | - | Yes |\n\nFree tier gives you single-provider lookups via Hunter. Pro unlocks the full 3-provider waterfall, email finder, company enrichment, and batch operations.\n\n**[Upgrade to Pro on MCPize](https://mcpize.com/mcp/leadenrich-mcp?ref=YHCCR&utm_source=github&utm_medium=readme)** — $29/mo or $290/yr.\n\n---\n\nBuilt by [Freedom Engineers](https://freedomengineers.tech)\n\n## Related\n\n- [SelfHeal MCP](https://mcpize.com/mcp/selfheal-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Self-healing proxy for MCP servers\n- [SiteHealth MCP](https://mcpize.com/mcp/sitehealth-mcp?ref=YHCCR&utm_source=github&utm_medium=readme) — Full website health audit\n",
  "bytes": 8328,
  "sha": "5fe894b8e759d33247981599f665566647fc95f851c527607469021f0d7b1387",
  "repo_slug": "carsonroell-debug/leadenrich-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_carsonroell_debug_leadenrich_m_4c235743/readme"
}