@leadloadz/mcp-server

Un servidor del Model Context Protocol (MCP) que conecta asistentes de IA con la plataforma de generación de leads B2B Leadloadz.

Características

• Buscar leads — Encuentra leads B2B verificados usando consultas en lenguaje natural

• Verificar correo electrónico — Verificación de correo electrónico en tiempo real con puntuación de entregabilidad

• Obtener estadísticas — Consulta tu uso y las cuotas restantes

Related MCP server: leads-mcp

Instalación

Vía npx (recomendado)

No requiere instalación. Los clientes de IA pueden ejecutar el servidor directamente:

npx -y @leadloadz/mcp-server

Vía npm

npm install -g @leadloadz/mcp-server
leadloadz-mcp

Configuración

Necesitas una clave de API de Leadloadz para usar este servidor.

1. Regístrate en leadloadz.com

2. Ve a Dashboard → API Tokens

3. Genera un nuevo token

4. Copia el valor del token

Claude Desktop

Añádelo a tu claude_desktop_config.json:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "tu-clave-api-aqui"
}
}
}
}

Cline (VS Code)

Añádelo a tus ajustes de MCP de Cline:

{
"mcpServers": {
"leadloadz": {
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "tu-clave-api-aqui"
}
}
}
}

Otros clientes

Cualquier cliente MCP que soporte transporte stdio puede usar:

{
"command": "npx",
"args": ["-y", "@leadloadz/mcp-server"],
"env": {
"LEADLOADZ_API_KEY": "tu-clave-api-aqui"
}
}

Variables de entorno

Desarrollo

# Instalar dependencias

npm install

# Construir

npm run build

# Comprobación de tipos

npm run typecheck

# Probar localmente

node dist/index.js

Publicar cambios (IMPORTANTE — LEE ESTO)

Cuándo publicar

Publica una nueva versión siempre que:

• Añadas nuevas herramientas o cambies esquemas de herramientas existentes

• Cambies el comportamiento de un endpoint de la API que afecte a las respuestas de MCP

• Corrijas errores en el código del servidor MCP

• Actualices dependencias (especialmente @modelcontextprotocol/sdk)

• Cambies variables de entorno u opciones de configuración

NO publiques por cambios en:

• La aplicación web principal de Leadloadz (es una base de código separada)

• Rutas de API en la aplicación Next.js (el servidor MCP actúa como proxy hacia ellas)

• Esquemas de base de datos (gestionados por la aplicación principal)

• Componentes de UI o páginas de marketing

Cómo publicar

Paso 1: Realiza tus cambios de código

Edita los archivos en src/ según sea necesario. Prueba localmente:

npm run build
npm test

Paso 2: Actualiza la versión

npm version patch   # para correcciones de errores
npm version minor   # para nuevas funciones
npm version major   # para cambios disruptivos

Paso 3: Actualiza server.json

Si cambiaste la versión, actualiza server.json para que coincida:

{
"version": "1.0.X",
"packages": [
{
"version": "1.0.X"
}
]
}

Paso 4: Confirma y envía a GitHub

git add .
git commit -m "Describe tus cambios"
git push origin master

Paso 5: Publicar en npm

echo "//registry.npmjs.org/:_authToken=TU_TOKEN_NPM" > .npmrc
npm publish --access public
rm -f .npmrc

Nota: El token de npm comienza con npm_. Mantenlo seguro y nunca lo confirmes en el repositorio.

Paso 6: Volver a publicar en el Registro MCP de Anthropic

El Registro MCP de Anthropic debe actualizarse siempre que publiques una nueva versión de npm:

# Iniciar sesión (el token caduca, por lo que es posible que debas hacerlo cada vez)

./mcp-publisher login github

# Sigue el flujo de autenticación del dispositivo:

# 1. Ve a https://github.com/login/device

# 2. Introduce el código mostrado

# 3. Autoriza la aplicación

# Publicar

./mcp-publisher publish

Crítico: El mcpName en package.json DEBE coincidir exactamente con el name en server.json (distingue entre mayúsculas y minúsculas). Actualmente ambos usan io.github.Ali1041/leadloadz.

Dónde se publica

Solución de problemas de publicación

Error "Token expired":

• Vuelve a ejecutar ./mcp-publisher login github

Error "You do not have permission":

• Asegúrate de que el nombre en server.json coincida con tu nombre de usuario de GitHub: io.github.Ali1041/leadloadz

• Asegúrate de que el mcpName en package.json coincida exactamente

Error "Validation failed":

• La descripción debe ser ≤ 100 caracteres

• Todos los campos requeridos en server.json deben estar presentes

• El paquete npm ya debe estar publicado con la versión coincidente

Seguridad

• Tu clave de API nunca se registra ni se expone en mensajes de error

• Todos los errores se desinfectan para evitar fugas de información

• El servidor se comunica directamente con las API de Leadloadz a través de HTTPS

• Los límites de tasa son aplicados por la API de Leadloadz

Soporte

• Sitio web: leadloadz.com

• Problemas: GitHub Issues

• Correo electrónico: support@leadloadz.com

Licencia

MIT