Servidor MCP de ZeroBounce
Un servidor integral de Model Context Protocol (MCP) que ofrece capacidades completas de validación, verificación e inteligencia de correos electrónicos a través de la API de ZeroBounce. Este servidor permite a los asistentes de codificación con IA y a los clientes compatibles con MCP validar direcciones de correo electrónico, encontrar correos, puntuar la calidad de los correos, buscar dominios y mucho más.
https://github.com/zerobounce/zerobounce-mcp
Funciones
Capacidades principales
Validación de correos electrónicos: Valide una o varias direcciones de correo electrónico con resultados detallados
Procesamiento por lotes: Procese de forma eficiente grandes volúmenes de correos electrónicos mediante la carga de CSV
Puntuación con IA: Evalúe la calidad y la entregabilidad de los correos electrónicos mediante IA a través de cargas masivas de archivos CSV
Buscador de correos electrónicos: Encuentre direcciones de correo electrónico según el nombre y la empresa/dominio
Búsqueda de dominio: Busque todas las direcciones de correo electrónico de un dominio
Datos de actividad: Compruebe si una dirección de correo electrónico ha estado activa recientemente
Gestión de créditos: Supervise los créditos restantes en su cuenta de ZeroBounce
Análisis de uso: Obtenga informes detallados de uso de la API para cualquier intervalo de fechas
Beneficios clave
🚀 Integración rápida: Configuración rápida con clientes compatibles con MCP
🔒 Seguro: Gestión de claves de API con compatibilidad para variables de entorno
📊 Amplia cobertura: Acceso a todos los endpoints principales de la API de ZeroBounce expuestos por el SDK oficial de Node y adecuados para herramientas MCP
🎯 Preciso: Precisión líder en la industria para la validación de correos electrónicosⓘ
🔄 En tiempo real: Resultados instantáneos de validación y puntuación
Inicio rápido
Instale el servidor MCP de forma global
npm install -g @zerobounce/mcp
Esto instalará el comando <strong>zerobounce-mcp</strong> de forma global.
Obtenga su clave de API de ZeroBounce desde el panel de ZeroBounce
Agréguela a su cliente MCP (Cursor, VS Code, Claude Desktop, etc.):
Comience a usarlo en su asistente de IA:
Obtener su clave de API
Su clave de API de ZeroBounce está disponible en el panel de ZeroBounce:
Inicie sesión en su cuenta de ZeroBounce
Diríjase a la sección API / Developer o Integraciones
Cree o copie una clave de API para esta integración
Utilice claves diferentes para desarrollo, staging y producción cuando sea posible
Nota: Trate su clave de API como una contraseña. No la comparta ni la incluya en el control de versiones.
Configuración del cliente MCP
La mayoría de los clientes compatibles con MCP utilizan la misma estructura básica de configuración. Un ejemplo mínimo se ve así:
Herramientas
El servidor MCP de ZeroBounce proporciona las siguientes herramientas, organizadas por categoría:
Herramientas de validación
- HerramientaDescripción
- validate_emailValide una sola dirección de correo electrónico mediante la API de ZeroBounce. Devuelve resultados detallados de validación, incluidos el estado, el subestado y metadatos adicionales.
- validate_batchValide varias direcciones de correo electrónico por lotes. Más eficiente para validar varios correos a la vez.
Herramientas de cuenta
- HerramientaDescripción
- get_creditsObtenga el número de créditos restantes en su cuenta de ZeroBounce.
- get_api_usageObtenga estadísticas de uso de la API para un intervalo de fechas. Muestra los conteos de validación por estado y subestado.
Herramientas de archivos de validación masiva
- HerramientaDescripción
- bulk_validate_send_fileEnvíe un archivo CSV para la validación masiva de correos electrónicos. Devuelve un ID de archivo para el seguimiento.
- bulk_validate_file_statusObtenga el estado de una carga de archivo de validación masiva.
- bulk_validate_get_fileObtenga los resultados de un archivo de validación masiva completado.
- bulk_validate_delete_fileElimine un archivo de validación masiva de su cuenta.
Herramientas de puntuación con IA
- HerramientaDescripción
- bulk_ai_scoring_send_fileEnvíe un archivo CSV para la puntuación masiva de correos electrónicos con IA. Devuelve un ID de archivo para el seguimiento.
- bulk_ai_scoring_file_statusObtenga el estado de una carga de archivo de puntuación masiva con IA.
- bulk_ai_scoring_get_fileObtenga los resultados de un archivo de puntuación masiva con IA completado.
- bulk_ai_scoring_delete_fileElimine un archivo de puntuación masiva con IA de su cuenta.
Herramientas de búsqueda de correos electrónicos
- HerramientaDescripción
- find_emailEncuentre una dirección de correo electrónico según el dominio, el nombre y/o la empresa.
Herramientas de búsqueda de dominio
- HerramientaDescripción
- domain_searchBusque direcciones de correo electrónico en un dominio.
Herramientas de datos de actividad
- HerramientaDescripción
- get_activity_dataObtenga datos de actividad de una dirección de correo electrónico para ver si ha estado activa recientemente.
Limitaciones y endpoints no compatibles
- Filtros personalizados / gestión de filtros: No están disponibles a través del SDK oficial de Node de ZeroBounce y, por lo tanto, no se exponen como herramientas MCP.
- List Evaluator: El endpoint de List Evaluator no es compatible con el SDK de Node y no está implementado en este servidor MCP.
- Herramienta de puntuación con IA por correo: La puntuación con IA actualmente solo es compatible mediante operaciones masivas de archivos CSV, no como una herramienta de puntuación de un solo correo electrónico.
Recursos
El servidor proporciona los siguientes recursos:
zerobounce://config — Configuración actual de la API de ZeroBounce (URL base y si la clave de API está configurada).
Ejemplos de uso
Validación básica de correos electrónicos
Valide un solo correo electrónico:
Validate the email address "test@example.com"
Valide con dirección IP para una mayor precisión:
Validate "test@example.com" from IP address "192.168.1.1"
Valide varios correos electrónicos por lotes:
Check if these emails are valid: ["user1@example.com", "user2@example.com", "user3@example.com"]
Gestión de la cuenta
Consulte los créditos restantes:
How many credits do I have left in my ZeroBounce account?
Obtenga estadísticas de uso:
Show me my ZeroBounce API usage for January 2024
Muestre el uso desde fechas específicas:
Get my API usage from 2024-01-01 to 2024-01-31
Puntuación de correos electrónicos con IA
Puntúe correos electrónicos mediante carga de CSV:
Use AI to score the quality and deliverability of these email addresses and return the results as a CSV: [paste CSV content]
Búsqueda de correos electrónicos
Encuentre un correo electrónico por nombre y dominio:
Find the email for John Doe at example.com
Encuentre un correo electrónico por nombre y empresa:
Find the email for John Doe at Example Corp (example.com)
Búsqueda de dominio
Busque correos electrónicos en un dominio:
Search for all email addresses at example.com
Busque con filtros:
Find emails for people named John at example.com
Datos de actividad
Compruebe la actividad del correo electrónico:
Check if test@example.com has been active recently
Operaciones masivas
Cargue un archivo para la validación masiva:
Bulk validate the emails in this CSV file: [paste CSV content]
Consulte el estado de la validación masiva:
Check the status of my bulk validation file abc123
Obtenga los resultados de la validación masiva:
Get the results for my completed bulk validation file abc123
Gestión de errores
El servidor gestiona los errores de forma adecuada y devuelve mensajes de error descriptivos:
Errores comunes
- ErrorCausaSolución
- Clave de API faltanteNo se proporcionó la clave de APIAgregue el argumento --api-key
- Clave de API no válidaLa clave de API es incorrecta o ha expiradoVerifique su clave de API en el panel de ZeroBounce
- Errores de redNo se puede conectar a la API de ZeroBounceCompruebe su conexión a Internet y la configuración del firewall
- Límite de solicitudesDemasiadas solicitudesEspere y vuelva a intentarlo, o actualice su plan de ZeroBounce
- Formato de correo electrónico no válidoEl formato de la dirección de correo electrónico no es válidoCompruebe el formato de la dirección de correo electrónico
- Formato de fecha no válidoLa fecha no está en formato YYYY-MM-DDUtilice el formato de fecha correcto (p. ej., "2024-01-31")
- Créditos insuficientesNo hay suficientes créditos en la cuentaAgregue créditos a su cuenta de ZeroBounce
- Archivo no encontradoEl ID del archivo de validación masiva no es válidoVerifique el ID del archivo a partir de la respuesta de carga
Formato de respuesta de error
Los errores se devuelven en un formato estructurado: