MailProbe

Verifique endereços de e-mail em tempo real, sem enviar nada: status e pontuação de entregabilidade, detecção de descartáveis, baseados em função e catch-all, correção de erros de digitação. Servidor remoto, hospedado na França.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

mailprobe-mcp

Servidor oficial do Model Context Protocol da API MailProbe. Seu assistente de IA verifica se endereços de e-mail existem e podem receber mensagens, em tempo real e sem enviar nada: um endereço, ou uma lista antes de uma campanha. A verificação é executada em servidores OVHcloud na França, e a API não armazena nenhum endereço.

Instalação · Ferramentas · Como se comporta · Desenvolvimento

Há duas maneiras de acessá-lo, com as mesmas duas ferramentas:

o servidor remoto que a MailProbe executa em https://mailprobe.dev/mcp, para um cliente que se conecta a um servidor remoto e pode enviar um cabeçalho: nada para instalar;
o servidor local deste pacote, npx -y mailprobe-mcp, para um cliente que inicia seus servidores no seu computador.

Este repositório também contém o plugin do Claude Code e a skill que ensina um assistente a ler um resultado e a percorrer uma lista.

Instalação

Crie uma conta em mailprobe.dev. Ela vem com 100 créditos gratuitos; veja preços para mais detalhes.
Crie uma chave de API, que começa com mp_live_, em Developer na sua conta. A MailProbe a mostra apenas uma vez, na criação.
Adicione um dos dois servidores ao seu cliente MCP.

Servidor remoto

A chave vai no cabeçalho Authorization. No Claude Code:

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

No Cursor, em .cursor/mcp.json:

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

Qualquer outro cliente que se conecte a um servidor MCP remoto e possa enviar um cabeçalho funciona da mesma forma.

Servidor local

A chave vai na variável de ambiente MAILPROBE_API_KEY, e o servidor precisa de Node.js 22 ou posterior. No Claude Desktop e nos outros clientes configurados com um arquivo JSON:

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

Os aplicativos Claude e ChatGPT se conectam a um servidor remoto apenas por meio de um login OAuth, que a MailProbe ainda não oferece. O Claude Desktop usa o servidor local acima; em outros lugares, a MailProbe está disponível por meio do Zapier MCP.

Plugin do Claude Code

O plugin conecta o Claude Code ao servidor remoto e adiciona uma skill que ensina o assistente a ler um resultado, quanto custa uma chamada e como percorrer uma lista.

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

O Claude Code pede a chave de API quando o plugin é ativado e a mantém no armazenamento de credenciais do sistema, não em um arquivo de configurações. Para defini-la depois, execute /plugin configure mailprobe@mailprobe, ou abra /plugin, aba Instalado, mailprobe, Opções de configuração. Um servidor remoto adicionado manualmente no mesmo endereço tem precedência sobre o do plugin.

Depois, peça o que precisar: "o e-mail jane@example.com existe?", "verifique os endereços de contacts.csv antes de eu enviar a newsletter", "quais desses cadastros são descartáveis?".

Ferramentas

Ferramenta	O que faz
`verify_emails`	Verifica de 1 a 20 endereços e retorna um resultado por endereço, na ordem dada: `status` (`valid`, `invalid`, `risky` ou `unknown`), um `score` de 0 a 100, o `reason` de um veredito que não é claramente entregável, os sinalizadores `disposable`, `role_based`, `free_provider` e `catch_all`, e `did_you_mean` para um possível erro de digitação
`get_credits`	Retorna os créditos restantes na conta da chave de API

Os campos de um resultado são os da API: veja a documentação da API.

Como se comporta

Nada é enviado ao endereço. A MailProbe verifica a sintaxe, os servidores de e-mail do domínio e então pergunta ao servidor de e-mail se a caixa de entrada existe, e para por aí.
Nada é armazenado. Um endereço verificado pela API é processado em memória e desaparece quando a resposta é enviada. Nenhum resultado é reutilizado para uma solicitação posterior.
As mesmas ferramentas em ambos os servidores. O servidor local carrega as instruções e as definições de ferramentas do remoto, palavra por palavra, e formula uma recusa da mesma forma. Ele não adiciona nada entre o assistente e a API: envia os endereços para https://mailprobe.dev/api/v1 e retorna a resposta.
Créditos. Um crédito por endereço efetivamente verificado, descontado da sua conta como na API. Um endereço repetido na mesma chamada, uma entrada que não é um endereço bem formado, um endereço que não pôde ser verificado a tempo e um cujo servidor recusou a conexão não custam nada. get_credits é gratuito.
Limite de taxa. A API aceita 60 chamadas por minuto para uma chave de API, e uma chamada de 20 endereços conta como uma. Uma chamada recusada informa o número de segundos para esperar. O servidor local espera sozinho e tenta novamente, no máximo duas vezes e apenas para atrasos de 30 segundos ou menos; caso contrário, o assistente recebe o atraso para esperar.
Tempo de resposta. Uma chamada responde em cerca de 95 segundos, por mais lentos que sejam os servidores de e-mail. Um endereço que não pôde ser verificado até lá retorna unknown com o motivo timeout, sem custo.
Listas longas. Uma chamada aceita 20 endereços, então um assistente envia uma lista em várias chamadas. Acima de algumas centenas de endereços, a tela de lote da sua conta é a ferramenta certa: uma lista colada de até 500 endereços, ou um arquivo CSV ou TXT de até 250.000, verificado em segundo plano.
Erros. Uma recusa volta ao assistente como uma frase na qual ele pode agir: a chave a definir, os créditos a comprar, o atraso a esperar.
Sem chave. O servidor local inicia e lista suas ferramentas; uma chamada explica como definir MAILPROBE_API_KEY.

Toda solicitação do servidor local carrega User-Agent: mailprobe-mcp/<version>. Mencione-o ao contatar o suporte: ele distingue suas chamadas nos logs da API.

Desenvolvimento

O servidor local não tem dependências: o Node.js executa os fontes como estão. Ele conversa com seu cliente via stdio e atende às duas eras do protocolo no mesmo processo: revisão 2026-07-28, em que cada solicitação carrega sua versão de protocolo, e as revisões anteriores (2025-11-25 até 2024-11-05), que começam com um handshake initialize.

npm test

executa os testes contra uma API MailProbe falsa em uma porta local: não são necessários chave nem rede. Eles também verificam se o pacote, o plugin, a skill e este README estão de acordo.

npm run check-tools

compara as instruções e as definições de ferramentas deste pacote com as do servidor remoto, que as fornece sem chave.

Plugin

plugin/ contém o plugin do Claude Code: seu manifesto, o .mcp.json que aponta para o servidor remoto, e a skill, plugin/skills/mailprobe/SKILL.md. .claude-plugin/marketplace.json é o catálogo que permite ao Claude Code instalar o plugin deste repositório. Nenhum deles faz parte do pacote npm.

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

verifica os manifestos e depois inicia uma sessão com o plugin carregado da pasta, sem instalá-lo. Um usuário recebe uma alteração do plugin ou da skill quando a versão muda: ela acompanha um lançamento.

Lançamento

Defina a versão em package.json e plugin/.claude-plugin/plugin.json, e date sua seção em CHANGELOG.md.
Execute npm test e npm run check-tools.
Faça o commit e envie uma tag com o nome da versão: o fluxo de trabalho Publish publica o pacote no npm por meio do Trusted Publishing, com uma declaração de procedência.

Recursos

Suporte

Abra uma issue ou escreva para contact@mailprobe.dev.

Licença

MIT, veja LICENSE.