LeadEnrich MCP

Enriquecimiento de leads en cascada para agentes de IA — utiliza Apollo, Clearbit y Hunter de forma secuencial para máxima cobertura de datos.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP LeadEnrich

Enriquecimiento de leads en cascada para agentes de IA. Recorre Apollo, Clearbit y Hunter para construir el perfil de lead más completo en una sola llamada.

Instalación en un clic: Instalar en MCPize | pip install leadenrich-mcp

LeadEnrich MCP expone el enriquecimiento de leads y empresas a través del Protocolo de Contexto de Modelos (MCP), para que herramientas como Claude y Cursor puedan ejecutar flujos de enriquecimiento directamente. Proporciónale un correo electrónico, dominio o nombre y devuelve un perfil combinado con atribución de campos que muestra qué proveedor aportó cada dato.

Conexión Rápida

1. Instalar e iniciar el servidor

pip install leadenrich-mcp
leadenrich-mcp

El servidor se inicia en http://localhost:8300/mcp por defecto.

2a. Conectar desde Claude Desktop

Añade a claude_desktop_config.json:

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

2b. Conectar desde Claude Code

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

Herramientas

Herramienta	Descripción
`enrich_lead`	Enriquecimiento completo en cascada para un solo lead (correo, dominio o nombre+dominio)
`find_email`	Descubre un correo electrónico a partir de nombre + apellido + dominio de empresa
`enrich_company`	Datos firmográficos de empresa por dominio (industria, tamaño, ingresos, etc.)
`enrich_batch`	Enriquecimiento por lotes de hasta 25 leads simultáneamente
`check_usage`	Cuota, seguimiento de costos y consultas restantes
`health_check`	Estado del servidor, proveedores configurados y estadísticas de caché

Cómo Funciona

LeadEnrich utiliza una estrategia en cascada: cada proveedor completa los vacíos que deja el anterior. Cuando se conoce el correo, todos los proveedores se ejecutan simultáneamente para mayor velocidad. Cuando solo se proporciona nombre+dominio, Apollo descubre primero el correo, y luego Clearbit y Hunter se ejecutan en 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 en el resultado incluye atribución para que sepas exactamente de qué proveedor proviene. Sin llamadas API duplicadas gracias al caché integrado.

Precios

Nivel	Costo	Detalles
Gratis	$0.00	50 consultas/mes
1 proveedor con datos	$0.05/consulta	Un solo proveedor devolvió datos
2 proveedores con datos	$0.10/consulta	Dos proveedores aportaron campos
3 proveedores con datos	$0.15/consulta	Cascada completa, máxima cobertura

Requisitos

Python 3.11+
pip

Inicio 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

Variables de Entorno

Variable	Descripción	Requerida
`APOLLO_API_KEY`	Clave API de Apollo.io	No
`CLEARBIT_API_KEY`	Clave API de Clearbit	No
`HUNTER_API_KEY`	Clave API de Hunter.io	No
`LEADENRICH_API_KEY`	Clave de autenticación de cliente para medición de uso	No
`LEADENRICH_FREE_TIER_LIMIT`	Límite del nivel gratuito (por defecto: 50)	No
`PORT`	Puerto del servidor (por defecto: 8300)	No

Todas las claves de proveedores son opcionales. El servidor utiliza los proveedores que estén configurados y omite el resto.

Ejemplo:

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

Opciones de Ejecución

Ejecutar directamente:

python main.py

Ejecutar mediante CLI de FastMCP:

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

Detalles de Herramientas

`enrich_lead`

Entradas:

email (opcional): Dirección de correo del contacto (mejor identificador)
domain (opcional): Dominio de la empresa (ej. "stripe.com")
first_name / last_name (opcional): Nombre del contacto (combinar con dominio)
providers (opcional): Limitar qué proveedores usar
api_key (opcional): Tu clave API de LeadEnrich

Devuelve el perfil de lead combinado con atribución de campos, puntuación de confianza y costo de consulta.

`find_email`

Entradas:

first_name (requerido): Nombre del contacto
last_name (requerido): Apellido del contacto
domain (requerido): Dominio de la empresa

Devuelve el correo descubierto con puntuación de confianza y estado de verificación.

`enrich_company`

Entrada:

domain (requerido): Dominio de la empresa

Devuelve datos firmográficos a nivel de empresa: industria, tamaño, ingresos, descripción, ubicación.

`enrich_batch`

Entradas:

leads (requerido): Lista de objetos de lead (máx. 25), cada uno con correo/dominio/nombre opcional
providers (opcional): Limitar qué proveedores usar
api_key (opcional): Tu clave API de LeadEnrich

Devuelve lista de perfiles enriquecidos con resumen del lote.

`check_usage`

Entrada:

api_key (opcional): Tu clave API de LeadEnrich

Devuelve estadísticas de uso: número de consultas, costo, nivel, cuota restante y estadísticas de caché.

`health_check`

Sin entrada. Devuelve estado del servidor, proveedores configurados, estadísticas de caché e información de versión.

Pruébalo

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"}'

Despliegue

Smithery

Este repositorio incluye smithery.yaml para el despliegue en Smithery.

Sube el repositorio a GitHub
Crea/añade el servidor en Smithery
Apunta Smithery a este repositorio

Docker / Plataformas de Alojamiento

Se incluye un Dockerfile para Railway, Fly.io y otros hosts de contenedores.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Configura las claves API de tus proveedores en el entorno de tu host.

Arquitectura

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 es una capa de traducción entre llamadas de herramientas MCP y múltiples APIs de proveedores de enriquecimiento, con caché integrado, medición de uso y lógica de fusión en cascada.

Gratis vs Pro

Herramienta	Gratis	Pro ($29/mes)
`enrich_lead`	Sí (solo Hunter)	Sí (cascada completa: Apollo + Clearbit + Hunter)
`check_usage`	Sí	Sí
`health_check`	Sí	Sí
`find_email`	-	Sí
`enrich_company`	-	Sí
`enrich_batch`	-	Sí

El nivel gratuito te da consultas de un solo proveedor mediante Hunter. Pro desbloquea la cascada completa de 3 proveedores, buscador de correos, enriquecimiento de empresas y operaciones por lotes.

Mejora a Pro en MCPize — $29/mes o $290/año.

Construido por Freedom Engineers

Relacionados

SelfHeal MCP — Proxy de autocuración para servidores MCP
SiteHealth MCP — Auditoría completa de salud de sitios web