MailVeri MCP

Servidor MCP para verificación de correos electrónicos de MailVeri: verifica correos individuales o listas masivas, consulta el saldo y descarga resultados desde Claude, Cursor y otros clientes MCP.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de MailVeri 🚀

Servidor oficial del Model Context Protocol (MCP) para MailVeri — Verificación de entregabilidad de correos electrónicos rápida, precisa y respetuosa con la privacidad para agentes de IA y asistentes de programación.

📖 Documentación interactiva: Para configuraciones avanzadas de clientes, parámetros de herramientas y códigos de error, visita nuestra Documentación oficial de MailVeri MCP.
📰 Tutorial paso a paso: Lee nuestra guía completa sobre Cómo verificar correos electrónicos directamente en Claude, Cursor y Windsurf.

Este servidor permite a los asistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Antigravity, OpenCode, Pi, Oh My Pi, etc.) verificar la entregabilidad de correos electrónicos, comprobar la existencia de buzones, consultar saldos de créditos y gestionar lotes de verificación masiva directamente desde el chat.

Funciones y herramientas

Herramienta	Descripción
`mailveri_verify_email`	Verifica una dirección de correo electrónico individual (devuelve `VALID`, `INVALID`, `DISPOSABLE`, `ROLE_ACCOUNT`, `CATCH_ALL`, `FULL_INBOX`, etc.).
`mailveri_get_balance`	Recupera los créditos de verificación restantes de tu cuenta de MailVeri.
`mailveri_verify_batch`	Pone en cola una lista de correos electrónicos (mínimo 2) para verificación distribuida en segundo plano.
`mailveri_get_batch_status`	Comprueba el porcentaje de progreso, el estado y los enlaces de descarga de un trabajo por lotes.
`mailveri_download_batch_result`	Obtiene el enlace de descarga de los resultados del lote completado (archivo ZIP completo o CSV filtrado personalizado por estado/columnas).
`mailveri_delete_batch`	Cancela o elimina un lote de verificación.

Inicio rápido

1. Obtén tu clave de API de MailVeri

Regístrate o inicia sesión en el Panel de MailVeri y copia tu clave de API desde Panel → Claves de API: 👉 https://app.mailveri.com/api-keys/

2. Configuración para Claude Desktop

Añade esta configuración al archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Nota: Requiere uv instalado en tu sistema (curl -LsSf https://astral.sh/uv/install.sh | sh o brew install uv).

3. Configuración para Claude Code

Ejecuta con la CLI de Claude Code de Anthropic:

claude mcp add mailveri -e MAILVERI_API_KEY=YOUR_MAILVERI_API_KEY -- uvx --from git+https://github.com/mailveri/mailveri-mcp mailveri-mcp

O añade a ~/.claude.json:

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

4. Configuración para Codex

Añade a la configuración de Codex (~/.codex/config.json):

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

5. Configuración para Cursor

En Cursor, abre Configuración > Funciones > Servidores MCP > Añadir nuevo servidor MCP:

Nombre: mailveri
Tipo: command
Comando: uvx --from git+https://github.com/mailveri/mailveri-mcp mailveri-mcp
Variables de entorno:
- MAILVERI_API_KEY: YOUR_MAILVERI_API_KEY

O añade a .cursor/mcp.json:

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

6. Configuración para Windsurf

Añade al archivo de configuración de Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

7. Configuración para OpenCode, Pi, Oh My Pi, Antigravity

Añade a la configuración MCP de tu herramienta (opencode.json, ~/.pi/config.json, ~/.omp/mcp.json o .gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "mailveri": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mailveri/mailveri-mcp",
        "mailveri-mcp"
      ],
      "env": {
        "MAILVERI_API_KEY": "YOUR_MAILVERI_API_KEY"
      }
    }
  }
}

Variables de entorno

Variable	Requerida	Predeterminada	Descripción
`MAILVERI_API_KEY`	Sí	—	Tu clave de API de MailVeri.
`MAILVERI_BASE_URL`	No	`https://api.mailveri.com`	Endpoint base de la API (útil para instancias de prueba o autoalojadas).

Opciones de transporte

Por defecto, el servidor utiliza el transporte stdio (recomendado para Claude Desktop / Cursor).

Para transporte SSE (útil para configuraciones remotas o de múltiples clientes):

export MAILVERI_API_KEY="your_api_key"
mailveri-mcp --transport sse --host 127.0.0.1 --port 8000

⚠️ Seguridad: El transporte SSE no tiene autenticación incorporada. Nunca lo vincules a 0.0.0.0 ni a una interfaz pública sin colocar un proxy inverso autenticado delante.

Indicador	Predeterminado	Descripción
`--transport`	`stdio`	Tipo de transporte: `stdio` o `sse`
`--host`	`127.0.0.1`	Host para vincular el transporte SSE
`--port`	`8000`	Puerto para vincular el transporte SSE
`--api-key`	—	Clave de API (alternativa a la variable de entorno)
`--base-url`	`https://api.mailveri.com`	URL base de la API

Límites de velocidad

Verificación de correo individual: 1 solicitud por segundo
Verificación por lotes: Sin límite por solicitud (los correos se ponen en cola en el servidor)

Agotamiento de créditos

Si tu cuenta se queda sin créditos de verificación, mailveri_verify_email devolverá un error con el mensaje "Not enough credits to verify email". Consulta tu saldo con mailveri_get_balance y recarga en Precios de MailVeri o en tu Panel de MailVeri.

Desarrollo y pruebas locales

Clona este repositorio y ejecuta localmente:

git clone https://github.com/mailveri/mailveri-mcp.git
cd mailveri-mcp

# Install dependencies
pip install -e .

# Run unit tests
python -m unittest discover -s tests

# Test running the MCP server locally (stdio)
export MAILVERI_API_KEY="your_api_key"
python -m mailveri_mcp.server

Ejemplos de indicaciones para IA

Una vez conectado, puedes pedirle a Claude o Cursor:

"Comprueba si alex@gmail.com y support@stripe.com son válidos y entregables."
"¿Cuántos créditos de verificación de correo me quedan en MailVeri?"
"Verifica esta lista de 20 correos de clientes potenciales y avísame del estado del lote."
"Obtén el enlace de descarga de resultados de mi lote de verificación."
"Dame un enlace de descarga CSV solo con los correos válidos y entregables del lote 'bX9K3LwZqP2YtR8vN4mQ'."