LeadMagic

Accede al conjunto de APIs de enriquecimiento de datos B2B de LeadMagic para encontrar correos electrónicos, enriquecer perfiles y obtener inteligencia empresarial.

GitHub

Prueba este MCPPatrocinado

Documentación

🚀 Servidor MCP de LeadMagic

[!IMPORTANT] Este servidor MCP local está obsoleto. LeadMagic ahora incluye un servidor MCP alojado con inicio de sesión OAuth (sin claves API en tu cliente) y la superficie completa de herramientas actuales — búsqueda de personas/empresas/empleos, enriquecimiento, investigación de anuncios y operaciones masivas:

https://mcp.leadmagic.io/mcp

Configuración para cada cliente (Claude, Claude Code, ChatGPT, Codex, Cursor y más): leadmagic.io/docs/mcp/setup

Habilidades de agente: npx skills add LeadMagic/leadmagic-skills

Plugin de Claude Code: LeadMagic/leadmagic-claude-plugin · Plugin de Cursor: LeadMagic/leadmagic-cursor-plugin

El paquete npm que aparece a continuación aún funciona con la API REST usando una X-API-Key, pero ya no recibe mantenimiento y carece de las herramientas más recientes. Migra al servidor alojado.

⚡ El Servidor de Protocolo de Contexto de Modelo Definitivo para el Enriquecimiento de Datos B2B

Integra sin problemas el conjunto completo de API de LeadMagic con Claude, Cursor, Windsurf y todas las herramientas de IA compatibles con MCP

🎯 19 Herramientas Potentes • 🔥 Configuración Cero • ⚡ Instalación en Una Línea • 🛡️ Seguridad Empresarial

🎯 Accede a los 19 endpoints de la API de LeadMagic a través del Protocolo de Contexto de Modelo para una integración perfecta con Claude, Cursor, Windsurf, Continue.dev y otras herramientas de IA compatibles con MCP.

🚀 Instalación Súper Fácil

⚡ Opción 1: Instalador Interactivo (Recomendado)

La forma más fácil de comenzar: funciona en macOS, Windows y Linux. Nuestro nuevo instalador interactivo, creado con React e Ink, hace que la configuración sea muy sencilla.

# 🔥 Using npx (no installation required)
npx leadmagic-mcp-server install

✨ El instalador:

✅ Validará tu clave API en tiempo real y mostrará tus créditos restantes.
✅ Detectarás y configurará automáticamente tu herramienta de IA preferida (Claude, Cursor, VS Code, etc.).
✅ Creará todos los archivos de configuración necesarios y un .env local para desarrollo.
✅ Proporcionará ejemplos de uso y enlaces útiles.

📱 Opción 2: Configuración Manual Rápida

Si prefieres la configuración manual o usas un cliente como Aider, puedes agregar la configuración del servidor directamente al archivo de configuración de tu cliente. El instalador interactivo proporciona fragmentos listos para copiar y pegar.

Ejecuta el instalador y elige la opción "Otro (Configuración Manual)":

npx leadmagic-mcp-server install

🔑 Obtén Tu Clave API

🌐 Visita el Panel de LeadMagic
📝 Regístrate gratis (si es necesario)
🔐 Genera tu clave API
📋 Pégala en el instalador interactivo cuando se te solicite.

⚡ Uso con npx (Instalación Cero)

Puedes usar el servidor sin instalarlo, lo cual es ideal para pruebas rápidas o entornos contenedorizados:

# 🚀 Run directly with your API key
LEADMAGIC_API_KEY=your-key npx leadmagic-mcp-server

# 📋 Run the interactive installer
npx leadmagic-mcp-server install

# ❓ Check available commands
npx leadmagic-mcp-server --help

🛠️ Herramientas Disponibles

📊 Operaciones Principales (3 herramientas)

💳 get_credits - Consulta el saldo de créditos de la API
✅ validate_email - Valida la entregabilidad del correo y obtén información de la empresa
📧 find_email - Encuentra direcciones de correo verificadas por nombre y empresa

🏢 Inteligencia de Perfiles y Empresas (5 herramientas)

👤 search_profile - Obtén detalles completos del perfil B2B (300 solicitudes/min)
🏭 search_company - Busca empresas por dominio, nombre o URL de perfil
📱 find_mobile - Encuentra números de teléfono móvil a partir de perfiles/correos
🔗 email_to_profile - Encuentra URLs de perfiles B2B a partir de correos laborales
💰 get_company_funding - Obtén datos de financiación, finanzas y competidores

✉️ Búsqueda Avanzada de Correos (2 herramientas)

📨 find_personal_email - Encuentra correos personales a partir de perfiles B2B
🔄 social_to_work_email - Encuentra correos laborales a partir de perfiles sociales

💼 Inteligencia de Empleos y Empleados (5 herramientas)

🔍 find_jobs - Busca ofertas de empleo con filtros avanzados
👔 find_role - Encuentra roles específicos dentro de empresas
👥 find_employees - Encuentra empleados de empresas específicas
🌍 get_job_countries - Obtén los países disponibles para búsqueda de empleo
📋 get_job_types - Obtén los tipos de empleo disponibles para filtrar

📱 Inteligencia de Anuncios (4 herramientas)

🔍 search_google_ads - Busca anuncios de Google Ads por empresa
📘 search_meta_ads - Busca anuncios de Meta (Facebook/Instagram)
📈 search_b2b_ads - Busca campañas publicitarias B2B
📄 get_b2b_ad_details - Obtén información detallada de anuncios B2B

💡 Ejemplos de Uso

Una vez instalado, puedes usar comandos en lenguaje natural en tu herramienta de IA:

📧 Operaciones de Correo

"Find the email for John Doe at Microsoft"
"Validate the email john@acme.com" 
"Find personal email for B2B profile https://linkedin.com/in/johndoe"

🏢 Inteligencia de Empresas

"Search for Tesla company information"
"Get funding information for Stripe"
"Find employees at OpenAI who work in engineering"

💼 Empleos y Reclutamiento

"Find software engineer jobs at tech companies"
"Search for product manager roles in San Francisco"
"Find mobile number for this B2B profile"

📱 Análisis Competitivo

"Search for Google Ads from competitor.com"
"Find Meta ads for company XYZ"
"Get B2B advertising campaigns for stripe.com"

🔧 Configuración de Desarrollo

📋 Requisitos Previos

📦 Node.js 18.0.0 o superior
🔑 Clave API de LeadMagic desde leadmagic.io

💻 Desarrollo Local

# 📥 Clone the repository
git clone https://github.com/LeadMagic/leadmagic-mcp.git
cd leadmagic-mcp

# 📦 Install dependencies
npm install

# 🔐 Create environment file
echo "LEADMAGIC_API_KEY=your-api-key-here" > .env

# 🚀 Start development server
npm run dev

# 🏗️ Build for production
npm run build

# ✅ Run validation
npm run validate

🔍 Pruebas con MCP Inspector

# 🚀 Start the MCP inspector
npm run inspector

# 🌐 Open the provided URL in your browser to test all tools

🌐 Clientes MCP Compatibles

Cliente	Instalación	Estado	Notas
🤖 Claude Desktop	Instalador interactivo o configuración manual	✅ Totalmente compatible	Cliente oficial de Anthropic
🎯 Cursor (Cline)	Instalador interactivo o configuración de VS Code	✅ Totalmente compatible	Requiere la extensión Cline
🏄 Windsurf	Instalador interactivo o configuración manual	✅ Totalmente compatible	IDE de IA de Codeium
🔄 Continue.dev	Instalador interactivo o archivo de configuración	✅ Totalmente compatible	Asistente de codificación de código abierto
💻 VS Code (Cline)	settings.json de VS Code	✅ Totalmente compatible	Requiere la extensión Cline
💻 VS Code (Continue)	Configuración de la extensión Continue	✅ Totalmente compatible	Requiere la extensión Continue
⚡ Zed Editor	Instalador interactivo o configuración	✅ Totalmente compatible	Editor de código moderno
🤖 Aider	Configuración manual	✅ Compatible	Programación en pareja con IA en tu terminal
✨ Augment Code	Configuración manual	✅ Compatible	Asistente de codificación con IA
🔗 Cualquier Cliente MCP	Configuración manual	✅ Compatible	Protocolo MCP estándar

🏗️ Arquitectura

🛠️ Pila Tecnológica

⚡ Runtime: Node.js 18+
📘 Lenguaje: TypeScript con verificación estricta de tipos
🔌 SDK de MCP: @modelcontextprotocol/sdk v1.0.0+
🌐 Cliente HTTP: Axios con manejo integral de errores
✅ Validación: Esquemas de Zod para todas las entradas/salidas de la API
🔧 Desarrollo: ESLint, Prettier, Jest para pruebas

📁 Estructura del Proyecto

├── src/
│   ├── index.ts        # 🚀 Main entry point and CLI command handling
│   ├── server.ts       # 🔌 MCP server implementation with all 19 tools
│   ├── client.ts       # 🌐 LeadMagic API client wrapper  
│   ├── types.ts        # 📝 TypeScript types and Zod schemas
│   └── install.tsx     # 🎨 The new interactive installer (React/Ink)
├── dist/               # 📦 Compiled JavaScript output
├── .env.example        # 🔐 Environment configuration example
└── README.md           # 📚 This file

📊 Referencia de API

🔤 Convención de Nombres de Campos

Todos los campos usan snake_case (coincidiendo con la API de LeadMagic):

{
  "first_name": "John",
  "company_name": "Acme Corp",
  "email_status": "valid"
}

🔐 Autenticación

Incluye tu clave API en las solicitudes:

X-API-Key: your-leadmagic-api-key

⏱️ Límites de Velocidad

👤 Búsqueda de Perfiles: 300 solicitudes/minuto
📊 Otros endpoints: Se aplican límites de velocidad estándar

❌ Manejo de Errores

Formato de error consistente en todos los endpoints:

{
  "error": "Bad Request", 
  "message": "API key is missing or invalid."
}

📈 Consumo de Créditos

Endpoint	Créditos	Notas
💳 `/credits`	0	Gratis para consultar
✅ `/email-validate`	0.05	Muy rentable
📧 `/email-finder`	1	Tarifa estándar
📱 `/mobile-finder`	5	Solo si se encuentra
👤 `/profile-search`	1	Con límite de velocidad (300/min)
🔗 `/b2b-profile`	10	Mayor costo por búsqueda inversa
💰 `/company-funding`	4	Inteligencia premium
💼 `/jobs-finder`	1 por empleo	Según resultados
🔍 `/google/searchads`	1 por anuncio	Según anuncios encontrados
📊 Todos los demás	1-2	Tarifas estándar

🔒 Seguridad y Buenas Prácticas

✅ Sin claves API en el código - Usa siempre variables de entorno ✅ Solicitudes con seguridad de tipos - Cobertura completa de TypeScript con validación de Zod ✅ Manejo de errores - Captura integral de errores y mensajes amigables para el usuario ✅ Límites de velocidad - Respeta los límites de velocidad de la API de LeadMagic ✅ Valores predeterminados seguros - Configuración lista para producción desde el inicio ✅ Instalador interactivo - Sin necesidad de editar archivos de configuración manualmente

🎯 Matriz de Instalación

Elige tu método de instalación según tu configuración:

Escenario	Comando	Ideal Para
🆕 Usuario por primera vez	`npx leadmagic-mcp-server install`	La configuración más fácil
🤖 Claude Desktop	Instalador interactivo → Opción 1	El más popular
🎯 Cursor/VS Code	Instalador interactivo → Opción 2/5	Desarrolladores
🔄 Múltiples clientes	Instalador interactivo → Opción 7	Usuarios avanzados
⚡ Prueba rápida	`LEADMAGIC_API_KEY=key npx leadmagic-mcp-server`	Pruebas
💻 Desarrollo local	Clonar repositorio + archivo `.env`	Contribuyentes