Leadbay

npx add-mcp 'https://mcp.leadbay.app/mcp'

Leadbay MCP

Leadbay MCP conecta tu asistente de IA con tu cuenta de Leadbay, para que puedas trabajar tus prospectos simplemente preguntando.

Obtén prospectos, califícalos, redacta mensajes de acercamiento y registra actividad, todo en lenguaje natural. Tu asistente actúa sobre tus datos reales de Leadbay, con tus permisos, tal como lo harías tú en la aplicación.

Todo está personalizado: no hay nada que configurar. Leadbay ejecuta IA avanzada en tu sitio web y en datos de mercado para encontrar y puntuar prospectos según tu perfil objetivo, de modo que el acercamiento se convierte en una conexión significativa en lugar de un spam sin sentido.

Dile a tu asistente qué prospectos quieres trabajar, conecta tus canales, y él obtiene los contactos de Leadbay y gestiona el acercamiento en tu nombre. Disfruta del acercamiento que ya no tienes que hacer.

MCP significa Model Context Protocol — un estándar abierto que permite a asistentes de IA como Claude conectarse de forma segura a herramientas y datos externos. Este servidor es de código abierto y vive en github.com/leadbay/mcp.

---

Cómo piensa Leadbay (modelo mental para tu agente)

• Bandeja de entrada, no una base de datos. Cada día, cuando el usuario inicia sesión, se entrega un lote nuevo de prospectos. El tamaño del lote se ajusta según cuántos prospectos haya trabajado el usuario recientemente; algunos flujos producen un gran flujo de prospectos más pequeños, otros un flujo reducido de prospectos más grandes. Pedir más no producirá más; actuar sobre los prospectos sí lo hace.
• Dos capas de puntuación. Cada prospecto viene con un score básico (firmográfico, ya decente, normalmente correlacionado con IA). Aproximadamente los 10 mejores de cada lote también están calificados por IA (investigación web dirigida + preguntas de calificación → ai_agent_lead_score). Los prospectos por debajo del top 10 no son peores: el sistema está ahorrando recursos. El agente puede solicitar una calificación más profunda (leadbay_bulk_qualify_leads) o enriquecimiento de contactos (leadbay_enrich_titles) en cualquier prospecto que parezca valer la pena.
• Ritmo diario. El agente funciona mejor como una revisión diaria: obtén prospectos nuevos, revisa rápidamente el top calificado automáticamente, profundiza en 1-3 prometedores, propón un acercamiento y luego registra lo que realmente se envió mediante leadbay_report_outreach. Si tu anfitrión admite programación, configura una ejecución diaria.

---

Para usuarios

Consigue Leadbay MCP funcionando dentro de tu asistente de IA en un par de minutos. Sin necesidad de programar.

¿Nuevo en Leadbay? La guía amigable con capturas de pantalla — qué es un lente, cómo funciona la puntuación y la configuración completa de MCP para cada asistente — vive en la guía de usuario de Leadbay. Este README es el complemento técnico.

¿Aún no tienes cuenta en Leadbay? Crea una aquí primero; la necesitarás para iniciar sesión durante la configuración.

Conéctate en la web (sin instalación)

Si usas Claude en la web, Claude Desktop o ChatGPT, la vía más rápida es un conector personalizado — sin terminal, sin tokens que copiar. Añade una URL e inicia sesión con tu navegador:

• Nombre: Leadbay
• URL: https://mcp.leadbay.app/mcp — una URL para todas las regiones (/fr/mcp sigue siendo un alias de compatibilidad)
• En ChatGPT, usa https://mcp.leadbay.app/chatgpt/mcp en su lugar. Mismo servidor, mismo inicio de sesión, mismos prospectos — pero el asistente no puede generar un enlace de recarga ni abrir tu página de facturación allí, porque el directorio de aplicaciones de OpenAI no permite que una aplicación venda créditos. Compra créditos o cambia tu plan en tu cuenta de Leadbay.

En Claude: Configuración → Conectores → + → Añadir conector personalizado, pega la URL, luego abre el conector y haz clic en Conectar. Inicia sesión con Leadbay, haz clic en Aprobar y estarás vinculado. El servidor gestiona OAuth dentro de la aplicación; las actualizaciones son automáticas — nunca tocas un archivo de configuración.

Instalar en Claude Desktop (paquete de un clic)

¿Prefieres una extensión de escritorio empaquetada? Descarga el archivo de un clic.

1. Descarga la extensión

👉 Descarga el último Leadbay MCP para Claude (.dxt)

En la página de versiones, haz clic en el archivo que termina en .dxt para descargarlo.

2. Instálalo

Haz doble clic en el archivo .dxt descargado. Claude se abre y muestra un diálogo de instalación — haz clic en Instalar y listo.

Si el doble clic no abre Claude, instálalo manualmente:

1. Abre Claude y ve a tu perfil → Configuración → Extensiones.
2. Abre Configuración avanzada.
3. Elige Instalar extensión… y selecciona el archivo .dxt que descargaste.

3. Inicia sesión

Claude te pedirá que conectes Leadbay. Inicia sesión con tu cuenta de Leadbay y estarás listo — solo pídele prospectos a tu agente.

¿Usas un asistente local?

Leadbay MCP también funciona con Claude Code, Claude Desktop, Cursor y Codex. El instalador universal configura todo por ti y te permite iniciar sesión con Leadbay.

Requiere Node.js 22+. Luego ejecuta:

npx -y -p @leadbay/mcp@latest installer

Se abre en tu navegador donde haces clic en Iniciar sesión con Leadbay y luego eliges qué asistentes conectar. Funciona en macOS, Windows y Linux.

Para desinstalar, ejecuta el mismo instalador con --uninstall:

npx -y -p @leadbay/mcp@latest installer --uninstall

Se abre una ventana de desinstalación que muestra solo los asistentes que tienen Leadbay conectado — elige cuáles eliminar y haz clic en Eliminar seleccionados. Solo elimina Leadbay; tus demás ajustes y conexiones quedan intactos.

Pide tus primeros prospectos

Abre una conversación nueva y describe el resultado — nunca nombras una herramienta, solo dices lo que quieres, como se lo pedirías a un colega:

Muéstrame los prospectos de hoy y dime cuáles dos vale la pena abrir primero.

Una primera respuesta exitosa es una tabla clasificada de prospectos, no un muro de texto: cada fila tiene una puntuación de ajuste, una línea de por qué encaja y el mejor contacto para llegar. Luego continúa:

Investiga el primero — ¿es adecuado para nosotros?

Redáctame un correo de acercamiento para ellos.

Acabo de enviarles un correo. Regístralo como acercamiento.

---

Para desarrolladores

Todo lo siguiente es para colaboradores y para cualquiera que ejecute Leadbay MCP desde el código fuente o lo integre en automatizaciones.

Instalar una versión local con el instalador personalizado

Para ejecutar tu copia local (en lugar del paquete publicado), primero compílala desde el código fuente:

pnpm install
pnpm prompts:build
pnpm -r build

Luego apunta el instalador a tu versión recién compilada con --local:

pnpm --filter @leadbay/mcp installer -- --local

--local registra los clientes MCP contra la compilación en tu árbol de trabajo en lugar de @leadbay/mcp@latest. OAuth se gestiona automáticamente — no necesitas pasar --oauth. El instalador pregunta por cada destino antes de escribir nada.

Todos los métodos de instalación

Cada forma compatible de conectar Leadbay MCP:

Método	Comando / acción	Plataformas	Notas
Conector alojado (sin instalación)	Añadir conector personalizado → https://mcp.leadbay.app/mcp (todas las regiones)	Claude web / Desktop	OAuth en navegador dentro de la aplicación. Nada que instalar; actualizaciones automáticas.
Conector alojado — ChatGPT	Añadir conector personalizado → https://mcp.leadbay.app/chatgpt/mcp	ChatGPT	Mismo servidor; las herramientas de recarga y facturación no están registradas (regla del directorio de OpenAI).
Paquete .dxt / .mcpb	Descargar desde Versiones, doble clic → Instalar	Claude Desktop	Extensión de escritorio de un clic.
Instalador guiado (GUI)	npx -y -p @leadbay/mcp@latest installer	macOS, Windows, Linux	Asistente en navegador: inicia sesión con Leadbay, elige clientes. Funciona para todos.
Compilación de desarrollo local	pnpm --filter @leadbay/mcp installer -- --local	macOS, Windows, Linux	Registra clientes contra tu compilación local. OAuth automático. Compila desde el código fuente primero (arriba).
Mercado de plugins de Claude Code	/plugin marketplace add leadbay/mcp luego /plugin install leadbay@leadbay-mcp	Claude Code	Registra el servidor MCP y instala habilidades de activación automática.

Qué escribe cada instalador por cliente

Los instaladores GUI/CLI solo tocan los clientes que están realmente instalados en la máquina:

Cliente	Comportamiento del instalador
Claude Code	Registra/elimina leadbay con claude mcp add/remove --scope user
Claude Desktop	Escribe/elimina solo la entrada mcpServers.leadbay en claude_desktop_config.json
Cursor	Escribe/elimina solo la entrada mcpServers.leadbay en la configuración MCP de Cursor
Codex	Escribe/elimina solo el bloque [mcp_servers.leadbay] en ~/.codex/config.toml y el bloque de exportación de shell gestionado por Leadbay

Mercado de plugins de Claude Code

/plugin marketplace add leadbay/mcp

/plugin install leadbay@leadbay-mcp

Claude Code solicita autenticación/configuración de Leadbay. Registra el servidor MCP y instala un conjunto de habilidades que se activan automáticamente con solicitudes en lenguaje natural — incluyendo leadbay_daily_check_in ("dame mis prospectos de hoy"), leadbay_research_a_domain ("investiga acme.com"), leadbay_followup_check_in, leadbay_qualify_top_n, leadbay_refine_audience, leadbay_log_outreach, leadbay_import_file, leadbay_plan_tour_in_city, leadbay_prospecting_overview, leadbay_extend_my_lens, leadbay_setup_team_prospecting, leadbay_build_campaign y leadbay_work_campaign. Cada SKILL.md se genera mediante @leadbay/promptforge desde la misma fuente que los prompts de MCP, por lo que las dos superficies nunca divergen.

Desinstalación

npx -y -p @leadbay/mcp@latest installer --uninstall

Abre el asistente de desinstalación — solo muestra los clientes que ya tienen Leadbay MCP configurado. Anula el registro de Claude Code, elimina el fragmento JSON de las configuraciones de Claude Desktop / Cursor, elimina el bloque TOML [mcp_servers.leadbay] de Codex y elimina el bloque export LEADBAY_* gestionado de ~/.zshrc / ~/.bashrc. La desinstalación se limita a Leadbay — nunca reescribe ajustes de clientes no relacionados ni elimina otros servidores MCP.

Herramientas

Tu asistente las llama en tu nombre — nunca las llamas directamente. Pides en lenguaje natural ("muéstrame los prospectos de hoy", "investiga acme.com", "registra que envié un correo a Jane") y el agente elige la herramienta correcta. La superficie predeterminada a continuación siempre está expuesta; la referencia completa por herramienta vive en la guía de usuario.

Herramientas de lectura (siempre activas)

Estas responden preguntas sobre tu cuenta. Ninguna crea, elimina ni envía nada. Algunas escriben una pequeña cosa mientras responden — qué prospectos se te mostraron o el filtro que pediste — y la tabla lo indica, porque es por eso que no se etiquetan como solo lectura en la red.

Descubrir y dar seguimiento

Herramienta	Descripción
leadbay_pull_leads	Obtén el lote fresco de hoy de prospectos puntuados y clasificados. Registra cada uno como visto, para que rote fuera del lote de mañana
leadbay_pull_followups	Obtén los prospectos que necesitan una acción de seguimiento. Guarda el filtro cuando pides uno
leadbay_account_status	Verifica cuota, créditos y estado de la cuenta
leadbay_scan_portfolio_signals	Escanea tus prospectos existentes en busca de una señal web en una sola pasada ("¿cuáles de mis prospectos adquirieron una empresa desde 2025?") — sin gastar cuota. Guarda el filtro cuando pides uno

Investigar una empresa

Herramienta	Descripción
leadbay_research_lead_by_id	Tarjeta de investigación profunda para un prospecto conocido — detalles + calificación de IA + contactos en una sola respuesta. Registra el prospecto como visto
leadbay_research_lead_by_name_fuzzy	Busca un prospecto por nombre de empresa o dominio cuando no tienes su ID. Registra el prospecto que encuentra como visto
leadbay_account_history	Historial completo de una cuenta — señales de IA actuales + todas las notas + línea de tiempo de interacciones, en una sola llamada ("¿por qué ha reaparecido esta cuenta?"). Registra el prospecto como visto
leadbay_prepare_outreach	Construye un resumen de acercamiento personalizado para un prospecto. Con enriquecimiento activado, también ordena los detalles del contacto

Viajes y ventas de campo

Herramienta	Descripción
leadbay_followups_map	Agrupa geográficamente tus seguimientos en un mapa para planificar viajes. Guarda el filtro cuando pides uno
leadbay_tour_plan	Construye un itinerario de visitas para un próximo viaje a una ciudad. Registra los nuevos prospectos que muestra como vistos

Campañas

Herramienta	Descripción
leadbay_list_campaigns	Lista tus campañas existentes
leadbay_campaign_progression	Muestra las métricas del embudo de una campaña
leadbay_campaign_call_sheet	Obtén la hoja de llamadas de una campaña

Lentes, audiencia y calificación

Herramienta	Descripción
leadbay_list_sectors	Lista las etiquetas reales de taxonomía de sectores — para que tú (y el agente) nombren los sectores correctamente, sin adivinar
leadbay_list_previously_enriched_titles	Recupera los títulos de puesto previamente enriquecidos por la organización (úsalo antes de leadbay_enrich_titles)
leadbay_list_lens_seed_candidates	Superficie de descubrimiento de solo lectura para construir una visión más amplia
leadbay_get_qualification_questions	Recupera las preguntas de calificación del agente de IA de la organización (cómo se puntúan los leads)
leadbay_get_lead_custom_fields	Recupera los valores de campos personalizados almacenados en un lead. Registra el lead como visto
leadbay_list_mappable_fields	Lista los campos del CRM a los que puedes mapear una importación. Dadas filas de ejemplo, las sube para obtener las sugerencias de mapeo del backend

Importaciones y trabajos

Herramienta	Descripción
leadbay_import_status	Estado de un trabajo de importación en ejecución
leadbay_qualify_status	Estado de un trabajo de calificación en ejecución
leadbay_bulk_enrich_status	Estado de un trabajo de enriquecimiento en ejecución
leadbay_resolve_import_rows	Mapea las filas importadas de vuelta a sus IDs de lead

Equipo, facturación y señales de producto

Herramienta	Descripción
leadbay_team_activity	Tabla de clasificación por representante orientada a gerentes + tendencia de actividad (los no administradores solo ven su propio alcance)
leadbay_create_topup_link	Genera un enlace de recarga de Stripe (pagas en tu navegador — no se cobra nada automáticamente)
leadbay_open_billing_portal	Abre el portal de facturación
leadbay_acknowledge_notification	Limpia una notificación de trabajo masivo terminal para que deje de reaparecer
leadbay_report_friction	Reporta un problema al equipo de Leadbay — te pregunta primero y te muestra lo que se envió (sin cambios en la cuenta)
leadbay_get_artifact_runtime	Obtiene los modelos de vista headless que el agente usa para construir un artefacto HTML interactivo

Acciones de escritura (activadas por defecto desde 0.3.0; establece LEADBAY_MCP_WRITE=0 para desactivarlas)

Estas acciones afectan tu cuenta. Cada acción es algo que podrías hacer tú mismo en la aplicación — no hay nada destructivo a nivel de plataforma, y las eliminaciones están sujetas a confirmación.

Calificar y enriquecer

Herramienta	Descripción
leadbay_bulk_qualify_leads	Activa la calificación por IA en un lote de leads
leadbay_enrich_titles	Enriquece contactos por título de puesto
leadbay_enrich_contacts	Enriquece a una persona específica (correo / teléfono) — el contacto que nombres, no un título de puesto

Prospección y actividad

Herramienta	Descripción
leadbay_report_outreach	Registra una acción de prospección (llamada, correo, reunión) — requerida después de cada contacto
leadbay_add_note	Añade una nota a un lead
leadbay_like_lead	Marca un lead como "me gusta" — enseña tu perfil de preferencias
leadbay_dislike_lead	Marca un lead como "no me gusta" — enseña tu perfil de preferencias

Contactos

Herramienta	Descripción
leadbay_add_contact	Añade una persona a una empresa (nombre + LinkedIn / título / correo / teléfono opcionales)
leadbay_remove_contact	Elimina un contacto que añadiste
leadbay_pin_contact	Fija un contacto como prioridad en una empresa
leadbay_unpin_contact	Desfija un contacto
leadbay_update_contact	Edita los detalles de un contacto (título, correo, LinkedIn…)

Lentes y audiencia

Herramienta	Descripción
leadbay_manage_lenses	Lista, cambia, renombra/describe o elimina tus lentes (la eliminación está sujeta a confirmación)
leadbay_new_lens	Crea una lente con nombre con criterios de sector / tamaño de empresa (y ubicación opcional)
leadbay_adjust_audience	Edita la audiencia de una lente ("deja de mostrarme empresas con más de 50 empleados"); pasa lensName para editar una lente por nombre
leadbay_extend_lens	Llena tu lente actual con más leads bajo demanda (sujeto a una cuota diaria de recarga)
leadbay_refine_lead_targeting	Refina el prompt de calificación que puntúa tus leads
leadbay_answer_clarification	Responde una pregunta de aclaración que Leadbay hizo sobre tu audiencia

Importaciones y campañas

Herramienta	Descripción
leadbay_import_leads	Importa una lista de dominios de empresas
leadbay_import_and_qualify	Importa una lista y califícala inmediatamente
leadbay_create_campaign	Crea una nueva campaña
leadbay_add_leads_to_campaign	Añade leads a una campaña
leadbay_remove_leads_from_campaign	Elimina leads de una campaña

Campos personalizados y preguntas de calificación

Herramienta	Descripción
leadbay_create_custom_field	Crea un campo personalizado del CRM (p. ej., para preservar un ID del sistema de origen)
leadbay_update_custom_field	Renombra o cambia el tipo de un campo personalizado
leadbay_delete_custom_field	Elimina un campo personalizado (sujeto a confirmación)
leadbay_set_qualification_questions	Modifica las preguntas de calificación del agente de IA de la organización (máx. 5; las eliminaciones están sujetas a confirmación)

Comentarios

Herramienta	Descripción
leadbay_send_feedback	Envía un mensaje al equipo de Leadbay (misma bandeja de entrada que el formulario de comentarios en la aplicación)

Herramientas granulares avanzadas (restringidas por LEADBAY_MCP_ADVANCED=1)

Herramientas de bajo nivel, de una sola llamada API, para usuarios avanzados e integraciones (leadbay_discover_leads, leadbay_get_lead_profile, leadbay_get_contacts, leadbay_list_lenses, …). Desactivadas por defecto; actívalas estableciendo LEADBAY_MCP_ADVANCED=1 en el entorno del servidor MCP. Consulta packages/mcp/README.md para la lista completa.

Cómo funciona

El servidor MCP usa automáticamente tu lente activa (la última lente que usaste en Leadbay). Solo llama a leadbay_pull_leads y funciona — no se necesita configuración de lente.

También puedes gestionar lentes directamente desde el chat: leadbay_manage_lenses las lista y cambia/renombra/elimina; leadbay_new_lens crea una con nombre con criterios de sector/tamaño; y leadbay_adjust_audience edita una lente existente (la activa, o cualquier lente por nombre mediante lensName). Los nombres de sectores se resuelven contra la taxonomía en vivo — leadbay_list_sectors muestra las etiquetas reales.

leadbay_research_lead_by_id agrupa múltiples llamadas API (detalles del lead + calificación por IA + contactos) en una sola respuesta. Si algunos datos aún no están disponibles, devuelve resultados parciales en lugar de fallar.

Configuración

Variable de entorno	Requerida	Descripción
LEADBAY_TOKEN	Sí	Credencial OAuth bearer local (establecida por el instalador)
LEADBAY_REGION	Sí	us o fr
LEADBAY_MCP_WRITE	No	Establécelo en 0 para desactivar las herramientas de escritura (por defecto: activadas desde 0.3.0)
LEADBAY_MCP_ADVANCED	No	Establécelo en 1 para exponer herramientas granulares (por defecto: desactivadas)
LEADBAY_BASE_URL	No	Sobrescribe la URL de la API (para staging/dev)
LEADBAY_TIMEOUT_MS	No	Plazo límite de respaldo para una solicitud saliente, en ms (por defecto: 600000)

La referencia completa de variables de entorno (telemetría, modo simulado, registro, tiempos de espera) está en packages/mcp/README.md.

Flujos de trabajo

El inventario canónico de lo que el MCP soporta — soportado / parcial / planificado / bloqueado por backend — es WORKFLOWS.md. Úsalo para clasificar solicitudes entrantes: encuentra la fila que coincida, o añade una nueva. Una pequeña auditoría verifica que cada herramienta/prompt y ruta de prueba citada sea real, para que la tabla no pueda desviarse silenciosamente.

Prueba rápida:

leadbay_pull_leads → leadbay_research_lead_by_id → leadbay_prepare_outreach   # discover & research
leadbay_pull_followups → leadbay_followups_map → leadbay_prepare_outreach     # travel/geo follow-ups
leadbay_import_leads → leadbay_bulk_qualify_leads                             # import & qualify

Requisitos

• Node.js 22+
• Una cuenta de Leadbay

Política de privacidad

El servidor MCP de Leadbay accede a los datos de tu cuenta de Leadbay (leads, contactos, campañas, notas) en tu nombre a través de la API de Leadbay, usando un token que autorizas mediante OAuth. No lee tu historial de conversaciones, la memoria de Claude, ni archivos locales. El manejo de datos se rige por la política de privacidad y los términos de uso de Leadbay.

Compilación desde el código fuente

pnpm install

pnpm prompts:build

pnpm -r build

pnpm -r test

pnpm -r typecheck

Niveles de prueba

• Pruebas unitarias (packages/core/test/unit/) — mapeo de códigos de error, ramas de herramientas. Usa mockHttp desde test/harness.ts para simular node:https. No se requiere red.
• Pruebas de integración (packages/core/test/integration/) — opcionales. Establece LEADBAY_TEST_TOKEN y ejecuta pnpm test:smoke.
• Pruebas de auditoría (packages/mcp/test/audit/) — verifican descripciones de herramientas, bloques de enrutamiento y la consistencia de WORKFLOWS.md en tiempo de compilación. Siempre se ejecutan en CI.
• Evaluaciones de agentes (evals/) — recorridos declarativos, agentes de prueba aislados y verificación de evidencia independiente. pnpm test:eval valida los contratos de artefactos; no afirma cobertura de comportamiento.

Consulta CLAUDE.md para la guía completa de contribuidores: estructura de herramientas, convenciones de prueba, canalización de compilación y cómo añadir una nueva herramienta.

Publicación

Todos los lanzamientos están impulsados por etiquetas — nunca ejecutes npm publish localmente. GitHub Actions es el propietario de la publicación.

1. Incrementa packages/mcp/package.json#version + añade una entrada en CHANGELOG, fusiona el PR.

git checkout main && git pull

git tag mcp-v0.x.0

git push origin mcp-v0.x.0

2. Observa el flujo de trabajo de lanzamiento: preflight-npm → publish-mcp.

Para ejecuciones de prueba: Actions → release → "Run workflow" → package: mcp, dry_run: true.

Manual completo (configuración de autenticación, modos de fallo, re-ejecuciones manuales): RELEASE.md.