Verificação de Email para Agentes de IA via MCP

Um agente de IA que lida com cadastros, prospecção ou higiene de CRM continua batendo na mesma parede: ele não tem ideia se um endereço de e-mail é real. Ele enviará alegremente um e-mail para gmial.com, aceitará um descartável mailinator.com como um novo usuário ou importará um domínio morto para o seu banco de dados. O agente não está errado em tentar; ele apenas não tem noção de entregabilidade.

O MCP (Protocolo de Contexto de Modelo) é a maneira limpa de fechar essa lacuna. Em vez de codificar um cliente HTTP em cada agente, você aponta o agente para um servidor e ele obtém as ferramentas. Este post conecta Verifly via MCP, para que qualquer cliente compatível com MCP (Claude Desktop, Cursor, seu próprio tempo de execução de agente) possa verificar e limpar endereços de e-mail dentro de seu loop.

O caso de uso

Você está construindo um agente que integra usuários ou trabalha em uma lista de leads. Você quer que ele:

• rejeite cadastros falsos ou descartáveis antes que eles cheguem ao seu banco de dados, e
• limpe uma lista antes de uma campanha para que você não esteja enviando e-mails para endereços mortos.

Ambas são decisões que o agente deve tomar durante a tarefa, o que significa que a verificação precisa ser uma ferramenta que ele possa chamar, não um script que você execute depois.

Duas maneiras de conectar

Verifly executa um servidor MCP hospedado em https://verifly.email/mcp (HTTP transmitível, autenticação Bearer). Também há um pacote npm que executa o mesmo servidor localmente via stdio. Use o que seu cliente suportar.

Obtenha uma chave primeiro

Verifly é construído para agentes, então a integração é uma única chamada, sem painel:

curl -s -X POST https://verifly.email/api/v1/autonomous/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"a-strong-password"}'

Você receberá de volta uma api_key.key começando com vf_ e 100 créditos gratuitos.

Opção A: servidor hospedado (Claude Desktop / Cursor)

Adicione-o à sua configuração MCP. Para Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "verifly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://verifly.email/mcp"],
      "env": { "VERIFLY_API_KEY": "vf_your_key_here" }
    }
  }
}

Opção B: servidor local stdio

npx verifly-mcp-server

{
  "mcpServers": {
    "verifly": {
      "command": "npx",
      "args": ["-y", "verifly-mcp-server"],
      "env": { "VERIFLY_API_KEY": "vf_your_key_here" }
    }
  }
}

Reinicie o cliente e as ferramentas do Verifly aparecerão.

O que o agente realmente recebe

Após a conexão, um tools/list contra o servidor retorna um conjunto de ferramentas reais. Estas são as focadas em verificação:

• verify_email — verifica um endereço, retorna o veredicto, razão, bandeiras e uma recomendação de enviar/rejeitar.
• verify_batch — verifica uma lista de forma síncrona (boa até algumas centenas).
• clean_email_list — remove duplicatas, descarta sintaxe inválida, opcionalmente remove contas descartáveis e de função.
• extract_emails — extrai endereços de texto livre (assinaturas, notas coladas).
• check_domain_health — MX / SPF / DMARC e uma pontuação de saúde geral para um domínio.
• submit_bulk / get_job_status / get_job_results — trabalhos assíncronos para grandes listas.
• get_credits / get_account / get_usage — saldo e uso, sem créditos cobrados.

O agente escolhe o certo a partir das descrições. "Limpar esta lista" puxa clean_email_list; "este cadastro é real?" puxa verify_email.

Como é um veredicto

Quando o agente chama verify_email em um erro de digitação, o servidor ao vivo retorna isso (mostrado via a chamada REST subjacente que a ferramenta envolve):

{
  "email": "jane.doe@gmial.com",
  "result": "indeliverável",
  "reason": "E-mail inválido: domínio ruim",
  "confidence": 90,
  "recommendation": "não_envie",
  "did_you_mean": "jane.doe@gmail.com",
  "details":