Lusha a MCP: contactos B2B, prospección y señales en cualquier agente IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Lusha, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Lusha

Da a tu IA los datos B2B de Lusha: encuentra contactos y empresas por nombre, correo, URL de LinkedIn o dominio, prospecta por cargo, nivel, sector, tamaño y ubicación, revisa tus créditos y revela correos, teléfonos y datos de empresa solo de los registros que elijas. También lee señales de cambios de empleo y de empresas.

Configuración

1. Inicia sesión en Lusha con una cuenta que tenga acceso a la API. Solo los administradores de la cuenta y los managers con acceso a la API ven la página de API.
2. Abre API → Manage API Keys en https://dashboard.lusha.com/api/manage-api-keys y crea o copia una clave.
3. Pégala en LUSHA_API_KEY e instala el conector. La clave se envía en la cabecera api_key y solo a Lusha.
4. Comprueba la configuración con lusha_get_account_usage: muestra los créditos que quedan y el precio de cada acción, sin gastar créditos.

Las llamadas que devuelven registros cuestan créditos, así que la IA pregunta antes: la API v3 de Lusha cobra del saldo de créditos de tu cuenta cada llamada que devuelve datos, búsquedas incluidas. Los precios dependen de tu plan, y lusha_get_account_usage los muestra por acción (búsqueda, reveal de empresa, correo, teléfono, etc.).

• Gratis: lusha_get_account_usage (como máximo 5 llamadas por minuto), lusha_list_filters, lusha_get_filter_values, lusha_list_signal_types y consultar un trabajo de enriquecimiento con lusha_get_enrich_job.
• Un pequeño cargo por resultado encontrado (nada si no encuentra): lusha_search_contacts, lusha_search_companies, lusha_prospect_contacts y lusha_prospect_companies. Devuelven vistas previas sin correos ni teléfonos, más lo que revelaría un enriquecimiento y cuánto costaría.
• Más créditos: lusha_enrich_contacts (por cada correo y cada teléfono revelado; un teléfono suele costar varias veces lo que un correo), lusha_enrich_companies (por empresa), y lusha_get_contact_signals y lusha_get_company_signals (por señal encontrada).

Antes de cualquier llamada que cueste créditos, la IA te dice qué va a ejecutar, para cuántos registros y cuánto puede costar, y espera tu sí. Mantiene pequeñas las páginas de resultados y revela solo los campos que necesitas: solo correos cuesta menos que correos y teléfonos.

Cómo funciona: para personas y empresas que ya conoces, la IA busca por id de Lusha, URL de LinkedIn, correo, nombre más empresa, o nombre y dominio de la empresa. Para nuevos prospectos lee primero los valores válidos de los filtros (nivel, departamentos, sectores, tamaños de empresa, facturación, ubicaciones, tecnologías) y luego prospecta con filtros de inclusión y exclusión. Cuando eliges registros, los enriquece por id de Lusha, hasta 100 a la vez. Si Lusha responde con un trabajo para datos que llegan más tarde, la IA espera y lee el trabajo gratis.

Señales: cambios de empleo y ascensos de contactos, y picos de contratación, cambios de plantilla, tráfico web, gasto en TI, noticias y cambios de intención en empresas. lusha_list_signal_types las lista gratis; leer señales cuesta créditos por coincidencia.

Datos personales, solo para uso B2B: los registros de contactos describen a personas reales: nombres, cargos, empresas, correos de trabajo y personales, teléfonos móviles y directos. Úsalos solo para un fin empresarial legítimo que puedas justificar, como ventas B2B o selección de personal por interés legítimo, conforme al RGPD, la CAN-SPAM y las condiciones de Lusha. Guarda solo lo necesario, respeta la marca do-not-call de los teléfonos y la marca UE de los contactos, no crees listas de envío masivo y no busques a particulares. Lusha retiene algunas personas por motivos legales (HTTP 451 o COMPLIANCE_RESTRICTED). El conector da a la IA las mismas reglas.

Límites de uso: por defecto 25 solicitudes por segundo por cuenta, más cuotas por hora y por día según el plan. Un 429 significa esperar y volver a intentarlo.

Errores comunes: 401: la clave es incorrecta, está revocada o falta. 402: no quedan créditos. 403: la cuenta está inactiva o el plan no incluye una función. 400: un valor de filtro o parámetro no válido, que se indica en la respuesta. 451: Lusha no puede devolver a esta persona por motivos legales. Una respuesta correcta puede marcar registros sueltos como no encontrados, restringidos o fallidos.

El conector nunca cambia datos en Lusha. No busca y enriquece en una sola llamada (se saltaría tu confirmación) y no cubre lookalikes, buying groups, scoring, visitantes del sitio web, exportación al CRM, webhooks ni los antiguos endpoints v2.

Requisitos previos: LUSHA_API_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Lusha e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Lusha nos quedan y cuánto cuesta en nuestro plan revelar un correo o un teléfono?"
• "Busca responsables de marketing en empresas SaaS de España con 51 a 500 empleados. Enséñame una página pequeña de vistas previas y dime antes cuánto cuesta la búsqueda."
• "Revela solo los correos de trabajo de los dos primeros contactos. Dime el coste en créditos antes de hacerlo."
• "Revisa si acme.com, northwind.com y contoso.com tienen picos de contratación o cambios de plantilla. Dime antes el coste."
• "¿Alguno de estos cinco contactos ha cambiado de empleo o ha sido ascendido hace poco?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT