LeadMagic

Acesse o conjunto de APIs de enriquecimento de dados B2B da LeadMagic para localização de e-mails, enriquecimento de perfis e inteligência empresarial.

GitHub

Experimente este MCPPatrocinado

Documentação

🚀 Servidor MCP LeadMagic

[!IMPORTANT] Este servidor MCP local está obsoleto. O LeadMagic agora oferece um servidor MCP hospedado com login via OAuth (sem chaves de API no seu cliente) e toda a superfície atual de ferramentas — busca de pessoas/empresas/vagas, enriquecimento, pesquisa de anúncios e operações em lote:

https://mcp.leadmagic.io/mcp

Configuração para todos os clientes (Claude, Claude Code, ChatGPT, Codex, Cursor e outros): leadmagic.io/docs/mcp/setup

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

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

O pacote npm abaixo ainda funciona com a API REST usando um X-API-Key, mas não é mais mantido e não inclui as ferramentas mais recentes. Por favor, migre para o servidor hospedado.

⚡ O Servidor de Protocolo de Contexto de Modelo Definitivo para Enriquecimento de Dados B2B

Integre perfeitamente o conjunto completo de APIs do LeadMagic com Claude, Cursor, Windsurf e todas as ferramentas de IA compatíveis com MCP

🎯 19 Ferramentas Poderosas • 🔥 Configuração Zero • ⚡ Instalação em Uma Linha • 🛡️ Segurança Empresarial

🎯 Acesse todos os 19 endpoints da API do LeadMagic por meio do Protocolo de Contexto de Modelo para integração perfeita com Claude, Cursor, Windsurf, Continue.dev e outras ferramentas de IA compatíveis com MCP.

🚀 Instalação Super Fácil

⚡ Opção 1: Instalador Interativo (Recomendado)

A maneira mais fácil de começar — funciona em macOS, Windows e Linux. Nosso novo instalador interativo, construído com React e Ink, torna a configuração muito simples.

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

✨ O instalador irá:

✅ Validar sua chave de API em tempo real e mostrar seus créditos restantes.
✅ Detectar e configurar automaticamente sua ferramenta de IA preferida (Claude, Cursor, VS Code, etc.).
✅ Criar todos os arquivos de configuração necessários e um .env local para desenvolvimento.
✅ Fornecer exemplos de uso e links úteis.

📱 Opção 2: Configuração Manual Rápida

Se você preferir a configuração manual ou estiver usando um cliente como Aider, você pode adicionar a configuração do servidor diretamente ao arquivo de configurações do seu cliente. O instalador interativo fornece trechos copiáveis para isso.

Execute o instalador e escolha a opção "Outro (Configuração Manual)":

npx leadmagic-mcp-server install

🔑 Obtenha Sua Chave de API

🌐 Visite o Painel do LeadMagic
📝 Cadastre-se gratuitamente (se necessário)
🔐 Gere sua chave de API
📋 Cole-a no instalador interativo quando solicitado.

⚡ Uso com npx (Instalação Zero)

Você pode usar o servidor sem instalar, o que é ótimo para testes rápidos ou ambientes conteinerizados:

# 🚀 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

🛠️ Ferramentas Disponíveis

📊 Operações Principais (3 ferramentas)

💳 get_credits - Verifique o saldo de créditos da API
✅ validate_email - Valide a entregabilidade de e-mails e obtenha informações da empresa
📧 find_email - Encontre endereços de e-mail verificados por nome e empresa

🏢 Inteligência de Perfil e Empresa (5 ferramentas)

👤 search_profile - Obtenha detalhes completos do perfil B2B (300 req/min)
🏭 search_company - Pesquise empresas por domínio, nome ou URL de perfil
📱 find_mobile - Encontre números de telefone celular a partir de perfis/e-mails
🔗 email_to_profile - Encontre URLs de perfis B2B a partir de e-mails de trabalho
💰 get_company_funding - Obtenha dados de financiamento, financeiros e de concorrentes

✉️ Busca Avançada de E-mails (2 ferramentas)

📨 find_personal_email - Encontre e-mails pessoais a partir de perfis B2B
🔄 social_to_work_email - Encontre e-mails de trabalho a partir de perfis sociais

💼 Inteligência de Vagas e Funcionários (5 ferramentas)

🔍 find_jobs - Pesquise vagas de emprego com filtros avançados
👔 find_role - Encontre cargos específicos dentro de empresas
👥 find_employees - Encontre funcionários de empresas específicas
🌍 get_job_countries - Obtenha os países disponíveis para busca de vagas
📋 get_job_types - Obtenha os tipos de vaga disponíveis para filtragem

📱 Inteligência de Anúncios (4 ferramentas)

🔍 search_google_ads - Pesquise anúncios do Google Ads por empresa
📘 search_meta_ads - Pesquise anúncios do Meta (Facebook/Instagram)
📈 search_b2b_ads - Pesquise campanhas de publicidade B2B
📄 get_b2b_ad_details - Obtenha informações detalhadas de anúncios B2B

💡 Exemplos de Uso

Após a instalação, você pode usar comandos em linguagem natural na sua ferramenta de IA:

📧 Operações de E-mail

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

🏢 Inteligência de Empresas

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

💼 Vagas e Recrutamento

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

📱 Análise Competitiva

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

🔧 Configuração de Desenvolvimento

📋 Pré-requisitos

📦 Node.js 18.0.0 ou superior
🔑 Chave de API do LeadMagic em leadmagic.io

💻 Desenvolvimento 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

🔍 Testes com o MCP Inspector

# 🚀 Start the MCP inspector
npm run inspector

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

🌐 Clientes MCP Suportados

Cliente	Instalação	Status	Observações
🤖 Claude Desktop	Instalador interativo ou configuração manual	✅ Totalmente Suportado	Cliente oficial da Anthropic
🎯 Cursor (Cline)	Instalador interativo ou configurações do VS Code	✅ Totalmente Suportado	Requer a extensão Cline
🏄 Windsurf	Instalador interativo ou configuração manual	✅ Totalmente Suportado	IDE de IA da Codeium
🔄 Continue.dev	Instalador interativo ou arquivo de configuração	✅ Totalmente Suportado	Assistente de codificação de código aberto
💻 VS Code (Cline)	settings.json do VS Code	✅ Totalmente Suportado	Requer a extensão Cline
💻 VS Code (Continue)	Configuração da extensão Continue	✅ Totalmente Suportado	Requer a extensão Continue
⚡ Zed Editor	Instalador interativo ou configurações	✅ Totalmente Suportado	Editor de código moderno
🤖 Aider	Configuração Manual	✅ Suportado	Programação em par com IA no seu terminal
✨ Augment Code	Configuração Manual	✅ Suportado	Assistente de codificação com IA
🔗 Qualquer Cliente MCP	Configuração manual	✅ Suportado	Protocolo MCP padrão

🏗️ Arquitetura

🛠️ Pilha de Tecnologia

⚡ Runtime: Node.js 18+
📘 Linguagem: TypeScript com verificação estrita de tipos
🔌 SDK MCP: @modelcontextprotocol/sdk v1.0.0+
🌐 Cliente HTTP: Axios com tratamento abrangente de erros
✅ Validação: Esquemas Zod para todas as entradas/saídas da API
🔧 Desenvolvimento: ESLint, Prettier, Jest para testes

📁 Estrutura do Projeto

├── 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

📊 Referência da API

🔤 Convenção de Nomenclatura de Campos

Todos os campos usam snake_case (correspondendo à API do LeadMagic):

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

🔐 Autenticação

Inclua sua chave de API nas solicitações:

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

⏱️ Limites de Taxa

👤 Busca de Perfil: 300 solicitações/minuto
📊 Outros endpoints: Limites de taxa padrão se aplicam

❌ Tratamento de Erros

Formato de erro consistente em todos os endpoints:

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

📈 Consumo de Créditos

Endpoint	Créditos	Observações
💳 `/credits`	0	Gratuito para verificar
✅ `/email-validate`	0.05	Muito econômico
📧 `/email-finder`	1	Taxa padrão
📱 `/mobile-finder`	5	Somente se encontrado
👤 `/profile-search`	1	Com limite de taxa (300/min)
🔗 `/b2b-profile`	10	Custo mais alto para busca reversa
💰 `/company-funding`	4	Inteligência premium
💼 `/jobs-finder`	1 por vaga	Baseado nos resultados
🔍 `/google/searchads`	1 por anúncio	Baseado nos anúncios encontrados
📊 Todos os outros	1-2	Taxas padrão

🔒 Segurança e Boas Práticas

✅ Sem chaves de API no código - Sempre use variáveis de ambiente ✅ Solicitações com segurança de tipos - Cobertura completa de TypeScript com validação Zod ✅ Tratamento de erros - Captura abrangente de erros e mensagens amigáveis ao usuário ✅ Limite de taxa - Respeita os limites de taxa da API do LeadMagic ✅ Padrões seguros - Configuração pronta para produção desde o início ✅ Instalador interativo - Sem necessidade de edição manual de arquivos de configuração

🎯 Matriz de Instalação

Escolha seu método de instalação com base na sua configuração:

Cenário	Comando	Melhor Para
🆕 Usuário iniciante	`npx leadmagic-mcp-server install`	Configuração mais fácil
🤖 Claude Desktop	Instalador interativo → Opção 1	Mais popular
🎯 Cursor/VS Code	Instalador interativo → Opção 2/5	Desenvolvedores
🔄 Múltiplos clientes	Instalador interativo → Opção 7	Usuários avançados
⚡ Teste rápido	`LEADMAGIC_API_KEY=key npx leadmagic-mcp-server`	Testes
💻 Desenvolvimento local	Clonar repositório + arquivo `.env`	Contribuidores