LeadEnrich MCP

Enriquecimento de leads em cascata para agentes de IA — combina Apollo, Clearbit e Hunter para máxima cobertura de dados.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP LeadEnrich

Enriquecimento de leads em cascata para agentes de IA. Percorre Apollo, Clearbit e Hunter para construir o perfil de lead mais completo em uma única chamada.

Instalação em um clique: Instalar no MCPize | pip install leadenrich-mcp

O LeadEnrich MCP expõe enriquecimento de leads e empresas através do Model Context Protocol (MCP), para que ferramentas como Claude e Cursor possam executar fluxos de enriquecimento diretamente. Forneça um e-mail, domínio ou nome e ele retorna um perfil mesclado com atribuição de campos, mostrando qual provedor contribuiu com cada dado.

Conexão Rápida

1. Instale e inicie o servidor

pip install leadenrich-mcp
leadenrich-mcp

O servidor inicia em http://localhost:8300/mcp por padrão.

2a. Conecte pelo Claude Desktop

Adicione em claude_desktop_config.json:

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

2b. Conecte pelo Claude Code

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

Ferramentas

Ferramenta	Descrição
`enrich_lead`	Enriquecimento completo em cascata para um único lead (e-mail, domínio ou nome+domínio)
`find_email`	Descubra um e-mail a partir de nome + sobrenome + domínio da empresa
`enrich_company`	Dados firmográficos da empresa por domínio (setor, porte, receita, etc.)
`enrich_batch`	Enriquecimento em lote de até 25 leads simultaneamente
`check_usage`	Cota, controle de custos e consultas restantes
`health_check`	Status do servidor, provedores configurados e estatísticas de cache

Como Funciona

O LeadEnrich usa uma estratégia em cascata: cada provedor preenche lacunas deixadas pelo anterior. Quando o e-mail é conhecido, todos os provedores são executados simultaneamente para maior velocidade. Quando apenas nome+domínio é fornecido, o Apollo descobre o e-mail primeiro, e então Clearbit e Hunter são executados em paralelo.

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          |
  +------------------------------------------+

Cada campo no resultado inclui atribuição para que você saiba exatamente de qual provedor veio. Sem chamadas de API duplicadas graças ao cache integrado.

Preços

Nível	Custo	Detalhes
Gratuito	R$ 0,00	50 consultas/mês
1 provedor encontrado	R$ 0,05/consulta	Apenas um provedor retornou dados
2 provedores encontrados	R$ 0,10/consulta	Dois provedores contribuíram com campos
3 provedores encontrados	R$ 0,15/consulta	Cascata completa, cobertura máxima

Requisitos

Python 3.11+
pip

Início Rápido

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

Endpoint MCP:

http://localhost:8300/mcp

Variáveis de Ambiente

Variável	Descrição	Obrigatória
`APOLLO_API_KEY`	Chave da API Apollo.io	Não
`CLEARBIT_API_KEY`	Chave da API Clearbit	Não
`HUNTER_API_KEY`	Chave da API Hunter.io	Não
`LEADENRICH_API_KEY`	Chave de autenticação do cliente para medição de uso	Não
`LEADENRICH_FREE_TIER_LIMIT`	Limite do nível gratuito (padrão: 50)	Não
`PORT`	Porta do servidor (padrão: 8300)	Não

Todas as chaves de provedores são opcionais. O servidor usa os provedores configurados e ignora os demais.

Exemplo:

export APOLLO_API_KEY="your-apollo-key"
export CLEARBIT_API_KEY="your-clearbit-key"
export HUNTER_API_KEY="your-hunter-key"
python main.py

Opções de Execução

Execute diretamente:

python main.py

Execute via CLI do FastMCP:

fastmcp run main.py --transport streamable-http --port 8300

Detalhes das Ferramentas

`enrich_lead`

Entradas:

email (opcional): Endereço de e-mail do contato (melhor identificador)
domain (opcional): Domínio da empresa (ex.: "stripe.com")
first_name / last_name (opcional): Nome do contato (combine com o domínio)
providers (opcional): Limite quais provedores usar
api_key (opcional): Sua chave da API LeadEnrich

Retorna o perfil do lead mesclado com atribuição de campos, pontuação de confiança e custo da consulta.

`find_email`

Entradas:

first_name (obrigatório): Primeiro nome do contato
last_name (obrigatório): Sobrenome do contato
domain (obrigatório): Domínio da empresa

Retorna o e-mail descoberto com pontuação de confiança e status de verificação.

`enrich_company`

Entrada:

domain (obrigatório): Domínio da empresa

Retorna dados firmográficos da empresa: setor, porte, receita, descrição, localização.

`enrich_batch`

Entradas:

leads (obrigatório): Lista de objetos de lead (máx. 25), cada um com e-mail/domínio/nome opcionais
providers (opcional): Limite quais provedores usar
api_key (opcional): Sua chave da API LeadEnrich

Retorna lista de perfis enriquecidos com resumo do lote.

`check_usage`

Entrada:

api_key (opcional): Sua chave da API LeadEnrich

Retorna estatísticas de uso: número de consultas, custo, nível, cota restante e estatísticas de cache.

`health_check`

Sem entrada. Retorna status do servidor, provedores configurados, estatísticas de cache e informações de versão.

Experimente

fastmcp list-tools main.py
fastmcp call-tool main.py health_check '{}'
fastmcp call-tool main.py enrich_lead '{"email":"jane@stripe.com"}'
fastmcp call-tool main.py find_email '{"first_name":"Jane","last_name":"Smith","domain":"stripe.com"}'
fastmcp call-tool main.py enrich_company '{"domain":"stripe.com"}'

Implantação

Smithery

Este repositório inclui smithery.yaml para implantação no Smithery.

Envie o repositório para o GitHub
Crie/adicione o servidor no Smithery
Aponte o Smithery para este repositório

Docker / Plataformas de Hospedagem

Um Dockerfile está incluído para Railway, Fly.io e outros hosts de contêineres.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Defina as chaves de API dos provedores no ambiente do seu host.

Arquitetura

Agent (Claude, Cursor, etc.)
  -> MCP
LeadEnrich MCP Server (this repo)
  -> Apollo API    (contact + company data)
  -> Clearbit API  (person + firmographic data)
  -> Hunter API    (email finding + verification)

Este servidor é uma camada de tradução entre chamadas de ferramentas MCP e múltiplas APIs de provedores de enriquecimento, com cache integrado, medição de uso e lógica de mesclagem em cascata.

Gratuito vs Pro

Ferramenta	Gratuito	Pro (R$ 29/mês)
`enrich_lead`	Sim (somente Hunter)	Sim (cascata completa: Apollo + Clearbit + Hunter)
`check_usage`	Sim	Sim
`health_check`	Sim	Sim
`find_email`	-	Sim
`enrich_company`	-	Sim
`enrich_batch`	-	Sim

O nível gratuito oferece consultas com um único provedor via Hunter. O Pro desbloqueia a cascata completa com 3 provedores, localizador de e-mails, enriquecimento de empresas e operações em lote.

Atualize para o Pro no MCPize — R$ 29/mês ou R$ 290/ano.

Construído por Freedom Engineers

Relacionados

SelfHeal MCP — Proxy de autocorreção para servidores MCP
SiteHealth MCP — Auditoria completa de saúde de sites