isBusinessEmail

Conecta Claude, ChatGPT, Cursor, VS Code y otros clientes MCP a isBusinessEmail: URL del servidor, inicio de sesión OAuth, herramientas, ejemplos de prompts y límites.

Ver como Markdown

isBusinessEmail ejecuta un servidor MCP remoto (Model Context Protocol). Conéctalo una vez y tu asistente de IA podrá verificar si una dirección es un correo de trabajo, clasificar una lista de clientes potenciales o averiguar si una empresa usa Google Workspace o Microsoft 365, usando tu cuenta y cuota.

https://api.isbusinessemail.com/mcp

Transporte	HTTP Streamable (respuestas JSON, sin sesiones)
Inicio de sesión	OAuth 2.1 con PKCE, a través de tu cuenta de isBusinessEmail. O envía una clave API como token Bearer.
Costo	Gratis. Cada verificación cuenta para tu cuota diaria, como una llamada API.

Conecta tu asistente

Claude (web, escritorio y móvil)

1. Abre Configuración → Conectores y elige Añadir conector personalizado.
2. Nómbralo isBusinessEmail y pega https://api.isbusinessemail.com/mcp como URL.
3. Selecciona Conectar, inicia sesión en isBusinessEmail (o crea una cuenta gratuita) y selecciona Permitir acceso.

En los planes Team y Enterprise, un propietario añade el conector para la organización primero.

Claude Code

claude mcp add --transport http isbusinessemail https://api.isbusinessemail.com/mcp

Luego ejecuta /mcp dentro de Claude Code y elige Autenticar. Se abre una ventana del navegador para iniciar sesión.

ChatGPT

Añade un conector personalizado (en modo desarrollador, según tu plan) con la URL del servidor https://api.isbusinessemail.com/mcp y autenticación OAuth. ChatGPT se registra y abre la página de inicio de sesión.

Cursor

~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "isbusinessemail": { "url": "https://api.isbusinessemail.com/mcp" }
  }
}

Cursor muestra Necesita inicio de sesión junto al servidor; selecciónalo para iniciar sesión.

VS Code

.vscode/mcp.json:

{
  "servers": {
    "isbusinessemail": { "type": "http", "url": "https://api.isbusinessemail.com/mcp" }
  }
}

Cualquier otro cliente, con una clave API

Si tu cliente no puede usar OAuth, usa una clave secreta de tu panel como encabezado:

{
  "mcpServers": {
    "isbusinessemail": {
      "url": "https://api.isbusinessemail.com/mcp",
      "headers": { "Authorization": "Bearer ibe_live_your_key" }
    }
  }
}

Mantén las claves fuera de repositorios compartidos. Una conexión OAuth es más segura: crea su propia clave que puedes revocar sin afectar tus otras integraciones.

Herramientas

Herramienta	Qué hace	Cuenta como
check_email	Clasifica una dirección: categoría, is_business, recomendación, razones, sugerencia de error tipográfico, proveedor de correo, Google Workspace / Microsoft 365	1 verificación
check_domain	Lo mismo para un dominio, para cuando solo te importa la empresa	1 verificación
check_batch	Hasta 100 direcciones o dominios en una llamada, resultados en orden de entrada	1 verificación por elemento
get_usage	Nivel, límites, verificaciones usadas y restantes hoy, últimos 30 días	gratis
report_wrong_verdict	Reporta una dirección o dominio mal clasificado; una persona lo revisa	gratis (50 al día)

Las herramientas de verificación aceptan un policy opcional (b2b, strict o lenient; consulta Categorías y políticas). Cada herramienta devuelve un resumen breve de texto para el asistente y la respuesta completa de la API como contenido estructurado, con los mismos campos que POST /v1/check.

Cosas para preguntar

• "¿Es jane@acme.io un correo de trabajo? ¿Acme usa Google Workspace o Microsoft 365?"
• "Aquí hay 40 registros de esta semana. ¿Cuáles son personales o desechables?"
• "Clasifica estos clientes potenciales por dominio de correo y dime cuáles enviar a ventas."
• "¿Por qué contoso.com se clasificó como negocio? Muéstrame las razones."
• "¿Cuántas verificaciones me quedan hoy?"

Cómo funciona el inicio de sesión

El servidor sigue la especificación de autorización MCP:

1. Sin token, /mcp responde a 401 con un encabezado WWW-Authenticate que apunta a https://api.isbusinessemail.com/.well-known/oauth-protected-resource/mcp.
2. El cliente lee los metadatos del servidor de autorización en https://api.isbusinessemail.com/.well-known/oauth-authorization-server, luego se registra (registro dinámico de clientes).
3. Inicias sesión en isbusinessemail.com y apruebas la aplicación. PKCE (S256) es obligatorio.
4. La aplicación recibe una clave secreta llamada MCP · . Aparece en tus claves, con su propio uso. Revócala allí para desconectar la aplicación. Conectar la misma aplicación de nuevo reemplaza su clave anterior.

Límites y privacidad

• Las verificaciones MCP usan los límites de velocidad y la cuota diaria de tu cuenta. Cuando la cuota se agota, las herramientas devuelven un error quota_exceeded hasta las 00:00 UTC.
• El servidor MCP ve los mismos datos que la API: las direcciones y dominios que envía tu asistente. Nunca envía correos ni los sondea. Consulta Privacidad y datos.
• Tu asistente decide cuándo llamar a una herramienta. La mayoría de los clientes preguntan antes de ejecutar herramientas; revisa la configuración de tu cliente.

Solución de problemas

Síntoma	Solución
El cliente dice que el servidor necesita autenticación	Conéctate de nuevo y completa el inicio de sesión en el navegador.
"Esta cuenta ya tiene el número máximo de claves API activas"	Revoca una clave no utilizada en /app/keys y luego conéctate de nuevo.
Las herramientas devuelven quota_exceeded	Espera el reinicio a las 00:00 UTC, o solicita más.
Las herramientas devuelven invalid_token	La clave fue revocada. Conéctate de nuevo.