MailProbe

npx add-mcp 'https://mailprobe.dev/mcp'

mailprobe-mcp

Servidor oficial del Model Context Protocol de la API de MailProbe. Tu asistente de IA comprueba si las direcciones de correo existen y pueden recibir mensajes, en tiempo real y sin enviar nada: una dirección, o una lista antes de una campaña. La verificación se ejecuta en servidores de OVHcloud en Francia, y la API no almacena ninguna dirección.

Instalación · Herramientas · Cómo se comporta · Desarrollo

Hay dos formas de acceder a él, con las mismas dos herramientas:

• el servidor remoto que MailProbe ejecuta en https://mailprobe.dev/mcp, para un cliente que se conecta a un servidor remoto y puede enviar una cabecera: no hay nada que instalar;
• el servidor local de este paquete, npx -y mailprobe-mcp, para un cliente que inicia sus servidores en tu ordenador.

Este repositorio también contiene el plugin de Claude Code y la habilidad que indica al asistente cómo leer un resultado y cómo recorrer una lista.

Instalación

1. Crea una cuenta en mailprobe.dev. Incluye 100 créditos gratuitos; consulta precios para más información.
2. Crea una clave de API, que empieza por mp_live_, en Desarrollador dentro de tu cuenta. MailProbe solo la muestra una vez, en el momento de crearla.
3. Añade uno de los dos servidores a tu cliente MCP.

Servidor remoto

La clave va en la cabecera Authorization. En Claude Code:

claude mcp add --transport http mailprobe https://mailprobe.dev/mcp --header "Authorization: Bearer mp_live_..."

En Cursor, en .cursor/mcp.json:

{
  "mcpServers": {
    "mailprobe": {
      "url": "https://mailprobe.dev/mcp",
      "headers": { "Authorization": "Bearer mp_live_..." }
    }
  }
}

Cualquier otro cliente que se conecte a un servidor MCP remoto y pueda enviar una cabecera funciona de la misma manera.

Servidor local

La clave va en la variable de entorno MAILPROBE_API_KEY, y el servidor necesita Node.js 22 o posterior. En Claude Desktop y en los demás clientes configurados con un archivo JSON:

{
  "mcpServers": {
    "mailprobe": {
      "command": "npx",
      "args": ["-y", "mailprobe-mcp"],
      "env": { "MAILPROBE_API_KEY": "mp_live_..." }
    }
  }
}

Las aplicaciones Claude y ChatGPT se conectan a un servidor remoto solo mediante un inicio de sesión OAuth, que MailProbe aún no ofrece. Claude Desktop acepta el servidor local indicado arriba; en otros entornos, MailProbe está disponible a través de Zapier MCP.

Plugin de Claude Code

El plugin conecta Claude Code al servidor remoto y añade una habilidad que indica al asistente cómo leer un resultado, cuánto cuesta una llamada y cómo recorrer una lista.

/plugin marketplace add jamalofski/mailprobe-mcp
/plugin install mailprobe@mailprobe

Claude Code solicita la clave de API cuando se activa el plugin y la guarda en el almacén de credenciales del sistema, no en un archivo de configuración. Para configurarla más tarde, ejecuta /plugin configure mailprobe@mailprobe, o abre /plugin, pestaña Instalado, mailprobe, Opciones de configuración. Un servidor remoto añadido manualmente en la misma dirección tiene prioridad sobre el del plugin.

Después pide lo que necesites: "¿existe jane@example.com?", "comprueba las direcciones de contacts.csv antes de enviar el boletín", "¿cuáles de estos registros son desechables?".

Herramientas

Herramienta	Qué hace
verify_emails	Verifica de 1 a 20 direcciones y devuelve un resultado por dirección, en el orden dado: status (valid, invalid, risky o unknown), una score de 0 a 100, el reason de un veredicto que no es claramente entregable, los indicadores disposable, role_based, free_provider y catch_all, y did_you_mean para un posible error tipográfico
get_credits	Devuelve los créditos restantes en la cuenta de la clave de API

Los campos de un resultado son los de la API: consulta la documentación de la API.

Cómo se comporta

• No se envía nada a la dirección. MailProbe comprueba la sintaxis, los servidores de correo del dominio y luego pregunta al servidor de correo si el buzón existe, y se detiene ahí.
• No se almacena nada. Una dirección verificada a través de la API se procesa en memoria y desaparece cuando se envía la respuesta. Ningún resultado se reutiliza para una solicitud posterior.
• Las mismas herramientas en ambos servidores. El servidor local lleva las instrucciones y las definiciones de herramientas del remoto, palabra por palabra, y expresa una negativa de la misma manera. No añade nada entre el asistente y la API: envía las direcciones a https://mailprobe.dev/api/v1 y devuelve la respuesta.
• Créditos. Un crédito por dirección realmente sondeada, descontado de tu cuenta como con la API. Una dirección repetida en la misma llamada, una entrada que no es una dirección bien formada, una dirección que no pudo sondearse a tiempo y una cuyo servidor rechazó la conexión no cuestan nada. get_credits es gratuito.
• Límite de frecuencia. La API acepta 60 llamadas por minuto para una clave de API, y una llamada de 20 direcciones cuenta como una. Una llamada rechazada indica el número de segundos que hay que esperar. El servidor local espera por sí mismo y reintenta, como máximo dos veces y solo para esperas de 30 segundos o menos; de lo contrario, el asistente recibe la espera necesaria.
• Tiempo de respuesta. Una llamada responde en unos 95 segundos, por lentos que sean los servidores de correo. Una dirección que no pudo sondearse para entonces vuelve como unknown con el motivo timeout, sin cargo.
• Listas largas. Una llamada admite 20 direcciones, así que un asistente envía una lista en varias llamadas. Por encima de unos cientos de direcciones, la pantalla de procesamiento por lotes de tu cuenta es la herramienta adecuada: una lista pegada de hasta 500 direcciones, o un archivo CSV o TXT de hasta 250 000, verificadas en segundo plano.
• Errores. Una negativa vuelve al asistente como una frase sobre la que puede actuar: la clave que hay que configurar, los créditos que hay que comprar, la espera que hay que hacer.
• Sin clave. El servidor local se inicia y enumera sus herramientas; una llamada explica cómo configurar MAILPROBE_API_KEY.

Cada solicitud del servidor local lleva User-Agent: mailprobe-mcp/<version>. Menciónalo cuando contactes con el soporte: permite distinguir tus llamadas en los registros de la API.

Desarrollo

El servidor local no tiene dependencias: Node.js ejecuta las fuentes tal cual. Se comunica con su cliente a través de stdio y atiende ambas épocas del protocolo desde el mismo proceso: la revisión 2026-07-28, donde cada solicitud lleva su versión de protocolo, y las revisiones anteriores (2025-11-25 hasta 2024-11-05), que comienzan con un apretón de manos initialize.

npm test

ejecuta las pruebas contra una API de MailProbe simulada en un puerto local: no se necesitan clave ni red. También comprueban que el paquete, el plugin, la habilidad y este README coinciden.

npm run check-tools

compara las instrucciones y las definiciones de herramientas de este paquete con las del servidor remoto, que las proporciona sin clave.

Plugin

plugin/ contiene el plugin de Claude Code: su manifiesto, el .mcp.json que apunta al servidor remoto y la habilidad, plugin/skills/mailprobe/SKILL.md. .claude-plugin/marketplace.json es el catálogo que permite a Claude Code instalar el plugin desde este repositorio. Ninguno forma parte del paquete npm.

claude plugin validate . --strict
claude --plugin-dir ./plugin

comprueba los manifiestos y luego inicia una sesión con el plugin cargado desde la carpeta, sin instalarlo. Un usuario recibe un cambio del plugin o de la habilidad cuando cambia la versión: se distribuye con una publicación.

Publicación

1. Establece la versión en package.json y plugin/.claude-plugin/plugin.json, y fecha su sección en CHANGELOG.md.
2. Ejecuta npm test y npm run check-tools.
3. Haz commit y luego empuja una etiqueta con el nombre de la versión: el flujo de trabajo Publish publica el paquete en npm mediante Trusted Publishing, con una declaración de procedencia.

Recursos

• Documentación de la API de MailProbe
• Configuración de MCP en mailprobe.dev
• Especificación del Model Context Protocol

Soporte

Abre un issue o escribe a contact@mailprobe.dev.

Licencia

MIT, consulta LICENSE.