Servidor MCP de Qualisend
El servidor MCP (Model Context Protocol) de Qualisend permite que un agente de IA verifique direcciones de correo, limpie listas y compruebe la entregabilidad de los dominios de envío a través de Qualisend, en Claude, ChatGPT, Grok o cualquier cliente compatible con MCP, sin código y sin exportar CSV. Esta página explica cómo conectarlo, cómo se autentica, las doce herramientas que ofrece y cómo trata tus datos.
- Endpoint
- https://app.qualisend.com/api/mcp
- Transporte
- Streamable HTTP (JSON-RPC 2.0), sin estado
- Autenticación
- OAuth 2.1 (recomendado) o una clave de API de Qualisend
- Nombre en el registro
- com.qualisend/email-verification
Requisitos
- Una cuenta de Qualisend. El plan Free incluye 100 créditos de verificación que nunca caducan.
- Un cliente compatible con MCP: Claude, ChatGPT, Grok, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI, Zed, Goose, Windsurf o similares. Cada uno tiene su guía de configuración paso a paso.
Conectar el servidor
Añade el endpoint de abajo como conector personalizado en tu cliente y luego autentícate con el inicio de sesión de un clic o con una clave de API.
https://app.qualisend.com/api/mcpOpción A: inicio de sesión (OAuth 2.1)
Recomendada. Sin claves que copiar: tu cliente abre una página «Conectar Qualisend» donde inicias sesión y autorizas el acceso a un espacio de trabajo.
- Claude: Customize → Connectors → Add custom connector → pega el endpoint → Add y aprueba. (guía completa)
- ChatGPT: Settings → Security and login → Developer mode, y luego crea una app MCP personalizada en chatgpt.com/plugins. (guía completa)
- Grok: grok.com/connectors → New Connector → Custom → pega el endpoint. (guía completa)
Los tres están pensados para el inicio de sesión, no para pegar una clave. Los clientes de desarrollo (Claude Code, Cursor, VS Code, Zed, Goose, Codex CLI y Gemini CLI) aceptan ambas opciones.
Opción B: clave de API
¿Prefieres una credencial estática? En cualquier cliente que pueda enviar una cabecera en la petición, crea una clave en tu panel, en API de verificación → API keys, y pásala como token bearer:
Authorization: Bearer qs_live_…Una vez conectado, basta con preguntar: «verifica sales@acme.com», «¿son entregables estas 10 direcciones?» o «¿cuántos créditos de verificación me quedan?»
Autenticación
OAuth usa el estándar OAuth 2.1 con PKCE y registro dinámico de clientes, así que la conexión se limita al espacio de trabajo que apruebes. Los tokens de acceso son de corta duración (1 hora) y los tokens de actualización se rotan; los tokens y los códigos de autorización solo se almacenan como hashes, y las URI de redirección deben coincidir exactamente. La autenticación con clave de API usa un token bearer (qs_live_…) en la cabecera Authorization. En ambos casos, la autenticación es un valor explícito en una cabecera, nunca una cookie ni una sesión.
Herramientas
El servidor ofrece doce herramientas, basadas en el mismo motor que la API REST de Qualisend y organizadas en tres grupos. Las herramientas básicas de verificación funcionan con cualquier plan (incluido el plan Free); las herramientas de entregabilidad requieren el plan Pro de Qualisend y la comprobación de listas negras requiere el complemento Monitoreo de listas negras. Solo las tres herramientas verify_ consumen créditos: todo lo demás es gratis.
Verificación y limpieza
Las herramientas básicas de verificación, disponibles en todos los planes, incluido el plan Free. Las tres herramientas verify_ consumen 1 crédito por dirección; las lecturas son gratis.
verify_emailverify_emailsverify_listget_credit_balanceget_verificationEntregabilidad y autenticación
Diagnóstico de dominios de envío y de mensajes. No consume créditos; disponible en el plan Pro de Qualisend.
check_domaingenerate_dns_recordanalyze_email_headercheck_disposablecheck_typolookup_smtp_codeMonitoreo de la reputación
No consume créditos; requiere el complemento Monitoreo de listas negras de Qualisend.
check_blacklistUna llamada a verify_email devuelve el veredicto local inmediato y un job_id; el sondeo SMTP del buzón termina unos segundos después, así que usa get_verification (o vuelve a preguntar) para obtener el resultado final de las direcciones dudosas.
Cómo son los resultados
Cada dirección devuelve uno de cuatro veredictos (entregable, con riesgo, no entregable o desconocido), cada uno con un código de motivo legible por máquina, indicadores adicionales (catch-all, desechable, de rol, buzón lleno), el proveedor MX y una puntuación de confianza de 0 a 100. Son los mismos campos públicos que devuelve la API REST.
Créditos y límites de frecuencia
Cada verificación cuesta un crédito, tanto si el agente comprueba una dirección como mil; las lecturas (get_credit_balance y get_verification) son gratis. El conector usa el mismo saldo de créditos y los mismos límites de frecuencia que tu acceso a la API REST, así que puedes preguntar «¿cuántos créditos me quedan?» antes de un trabajo grande. El plan Free incluye 100 créditos que nunca caducan.
Seguridad y privacidad
El servidor MCP concede exactamente lo que apruebas, nada más.
Limitado a un espacio de trabajo
Cada llamada a una herramienta está autenticada (token OAuth o clave de API) y limitada al único espacio de trabajo que conectes. No hay ninguna vía de acceso a los datos de otros clientes, a funciones de administración ni a ningún sistema interno más allá del flujo de verificación. El servidor reutiliza las mismas comprobaciones de autenticación, alcance, límites de frecuencia y créditos que la API REST pública.
Solo el veredicto público
Las respuestas contienen solo los campos públicos de verificación que devuelve la API REST: nunca detalles internos del motor, de la infraestructura de sondeo ni transcripciones SMTP más allá del resultado de entregabilidad. El conector solo recibe las direcciones que envías; nunca accede a tus conversaciones con la IA, a tu historial de chat, a la memoria del asistente ni a tus archivos, y las direcciones enviadas nunca se usan para entrenar ningún modelo de IA ni de aprendizaje automático, ni se venden ni se comparten.
Sin cookies, sin CSRF
La autenticación es un token o una clave explícitos en la cabecera Authorization, nunca una cookie ni una sesión, así que el endpoint no tiene superficie de ataque entre sitios (CSRF). OAuth usa PKCE y coincidencia exacta de las URI de redirección, y los tokens y los códigos solo se almacenan como hashes.
De corta duración y revocable
Los tokens de acceso OAuth son de corta duración (1 hora) y los tokens de actualización se rotan. Revoca el acceso cuando quieras desconectando el conector en tu cliente de IA (OAuth) o revocando la clave de API en tu panel de Qualisend.
Tratamiento de datos
Qualisend es una empresa con sede en la UE y los datos que envías se almacenan y procesan en la UE. Los trabajos de verificación y sus resultados permanecen en tu espacio de trabajo hasta que los eliminas o cierras tu cuenta; puedes eliminar trabajos y resultados en cualquier momento. No vendemos, alquilamos ni compartimos las listas que envías, y no las usamos para entrenar modelos de IA ni de aprendizaje automático. Tienes todos los detalles (recogida, uso, conservación, encargados del tratamiento externos y tus derechos) en la Política de Privacidad, y nuestro enfoque de seguridad, en la página de Seguridad.
Revocar el acceso
Desconecta el conector en tu cliente de IA para revocar una conexión OAuth, o revoca la clave de API en tu panel de Qualisend, en API de verificación → API keys. Además, los tokens de acceso OAuth caducan por sí solos en el plazo de una hora.
Soporte
¿Dudas o problemas? Escribe a hello@qualisend.com. Consulta también el resumen de MCP y las guías de configuración por cliente, la API para desarrolladores y la referencia de la API.
Empieza gratis con 100 créditos y luego añade el endpoint a tu cliente.