MailVeri MCP

Servidor MCP para verificação de e-mail do MailVeri: verifique e-mails individuais ou listas em massa, consulte o saldo e baixe resultados do Claude, Cursor e outros clientes MCP.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP MailVeri 🚀

Servidor oficial do Model Context Protocol (MCP) para MailVeri — Verificação de entregabilidade de e-mail rápida, precisa e que respeita a privacidade para agentes de IA e assistentes de codificação.

📖 Documentação Interativa: Para configurações avançadas de clientes, parâmetros de ferramentas e códigos de erro, visite nossa Documentação oficial do MCP MailVeri.
📰 Tutorial Passo a Passo: Leia nosso guia completo sobre Como Verificar E-mails Diretamente no Claude, Cursor e Windsurf.

Este servidor permite que assistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Antigravity, OpenCode, Pi, Oh My Pi, etc.) verifiquem a entregabilidade de e-mails, chequem a existência de caixas de entrada, consultem saldos de créditos e gerenciem lotes de verificação em massa diretamente no chat.

Recursos e Ferramentas

Ferramenta	Descrição
`mailveri_verify_email`	Verifica um único endereço de e-mail (retorna `VALID`, `INVALID`, `DISPOSABLE`, `ROLE_ACCOUNT`, `CATCH_ALL`, `FULL_INBOX`, etc.).
`mailveri_get_balance`	Recupera os créditos de verificação restantes da sua conta MailVeri.
`mailveri_verify_batch`	Coloca uma lista de e-mails (mínimo 2) na fila para verificação distribuída em segundo plano.
`mailveri_get_batch_status`	Verifica a porcentagem de progresso, o status e os links de download de um lote.
`mailveri_download_batch_result`	Obtém o link de download dos resultados do lote concluído (arquivo ZIP completo ou CSV filtrado personalizado por status/colunas).
`mailveri_delete_batch`	Cancela ou exclui um lote de verificação.

Início Rápido

1. Obtenha sua Chave de API MailVeri

Cadastre-se ou faça login no Painel MailVeri e copie sua Chave de API em Painel → Chaves de API: 👉 https://app.mailveri.com/api-keys/

2. Configuração para Claude Desktop

Adicione esta configuração ao arquivo de configuração do 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"
      }
    }
  }
}

Observação: Requer uv instalado no seu sistema (curl -LsSf https://astral.sh/uv/install.sh | sh ou brew install uv).

3. Configuração para Claude Code

Execute com a CLI do Claude Code da Anthropic:

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

Ou adicione ao ~/.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. Configuração para Codex

Adicione à configuração do 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. Configuração para Cursor

No Cursor, abra Configurações > Recursos > Servidores MCP > Adicionar Novo Servidor MCP:

Nome: mailveri
Tipo: command
Comando: uvx --from git+https://github.com/mailveri/mailveri-mcp mailveri-mcp
Variáveis de Ambiente:
- MAILVERI_API_KEY: YOUR_MAILVERI_API_KEY

Ou adicione ao .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. Configuração para Windsurf

Adicione ao arquivo de configuração do 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. Configuração para OpenCode, Pi, Oh My Pi, Antigravity

Adicione à configuração MCP da sua ferramenta (opencode.json, ~/.pi/config.json, ~/.omp/mcp.json ou .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"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
`MAILVERI_API_KEY`	Sim	—	Sua Chave de API MailVeri.
`MAILVERI_BASE_URL`	Não	`https://api.mailveri.com`	Endpoint base da API (útil para instâncias de staging ou auto-hospedadas).

Opções de Transporte

Por padrão, o servidor usa transporte stdio (recomendado para Claude Desktop / Cursor).

Para transporte SSE (útil para configurações remotas ou com múltiplos clientes):

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

⚠️ Segurança: O transporte SSE não possui autenticação integrada. Nunca vincule a 0.0.0.0 ou a uma interface pública sem colocar um proxy reverso autenticador na frente.

Flag	Padrão	Descrição
`--transport`	`stdio`	Tipo de transporte: `stdio` ou `sse`
`--host`	`127.0.0.1`	Host para vincular no transporte SSE
`--port`	`8000`	Porta para vincular no transporte SSE
`--api-key`	—	Chave de API (alternativa à variável de ambiente)
`--base-url`	`https://api.mailveri.com`	URL base da API

Limites de Taxa

Verificação de e-mail único: 1 solicitação por segundo
Verificação em lote: Sem limite por solicitação (os e-mails são colocados na fila no servidor)

Esgotamento de Créditos

Se sua conta ficar sem créditos de verificação, mailveri_verify_email retornará um erro com a mensagem "Not enough credits to verify email". Verifique seu saldo com mailveri_get_balance e recarregue em Preços MailVeri ou no seu Painel MailVeri.

Desenvolvimento Local e Testes

Clone este repositório e execute 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

Exemplos de Prompts para IA

Depois de conectado, você pode pedir ao Claude ou Cursor:

"Verifique se alex@gmail.com e support@stripe.com são válidos e entregáveis."
"Quantos créditos de verificação de e-mail ainda tenho no MailVeri?"
"Verifique esta lista de 20 e-mails de leads e me informe o status do lote."
"Obtenha o link de download dos resultados do meu lote de verificação."
"Me dê um link de download CSV apenas com os e-mails válidos e entregáveis do lote 'bX9K3LwZqP2YtR8vN4mQ'."