Valide e-mails de Claude com o servidor botoi MCP
Conecte Claude Desktop ou Claude Code a 44 ferramentas de desenvolvedor via MCP. Valide e-mails, verifique registros MX e sinalize endereços descartáveis sem sair do editor.
Você está analisando um CSV de 500 inscrições de usuários em Claude. Metade dos endereços de e-mail parecem suspeitos; domínios temporários, erros ortográficos, endereços que cheiram a bots. Você pode exportar o arquivo, escrever um script Python, instalar uma biblioteca de validação, executá-la e colar os resultados novamente. Ou você pode pedir ao Claude para verificá-los usando uma ferramenta MCP que já esteja conectada a uma API de validação.
Essa segunda opção leva cerca de dez segundos. Este tutorial mostra como configurá-lo e três maneiras de usá-lo.
Conecte o servidor MCP
O servidor Botoi MCP é executado em api.botoi.com/mcp e expõe 44 ferramentas para desenvolvedores, incluindo validação de e-mail, detecção de e-mail descartável e pesquisas de DNS. Nenhuma instalação necessária. Adicione a URL do servidor à configuração do cliente e reinicie.
Claude Desktop
Abrir claude_desktop_config.json (Configurações > Desenvolvedor > Editar configuração) e adicione o servidor:
{
"mcpServers": {
"botoi": {
"type": "streamable-http",
"url": "https://api.botoi.com/mcp"
}
}
}
Código Claude
Execute isso no seu terminal:
claude mcp add botoi --transport streamable-http https://api.botoi.com/mcp
Cursora
Criar ou editar .cursor/mcp.json na raiz do seu projeto:
{
"mcpServers": {
"botoi": {
"url": "https://api.botoi.com/mcp",
"type": "streamable-http"
}
}
}
Reinicie seu cliente após salvar. Claude descobre todas as 44 ferramentas na primeira conexão.
Caso de uso 1: verifique um único e-mail
Faça uma pergunta simples a Claude: "Verifique se user@tempmail.org é um e-mail real." Claude escolhe o lookup_email ferramenta, envia a solicitação e retorna os resultados embutidos.
You: "Check if user@tempmail.org is a real email."
Tool call: lookup_email
Input: { "email": "user@tempmail.org" }
Result:
{
"email": "user@tempmail.org",
"is_valid": true,
"is_disposable": true,
"is_free": false,
"mx_found": true,
"suggestion": null
}
Claude: "The address is syntactically valid and has working MX
records, but it belongs to a disposable email provider. This
signup is likely throwaway."
A resposta inclui quatro sinais: validade do formato, se existem registros MX para o domínio, se o provedor é um serviço descartável conhecido e uma sugestão de ortografia se o domínio parecer um erro de digitação (por exemplo, gmial.com → gmail.com).
Caso de uso 2: validação em lote de um CSV
Entregue a Claude um arquivo CSV e diga o que procurar. "Leia users.csv e sinalize todas as linhas onde o e-mail é descartável." Claude lê o arquivo, extrai a coluna do e-mail e liga para check_disposable_email para cada domínio exclusivo.
You: "Read users.csv and flag any rows where the email is disposable."
Claude reads the file, extracts the email column, and calls
disposable_email_check for each unique domain:
Tool call: check_disposable_email
Input: { "email": "alice@guerrillamail.com" }
Result: { "email": "alice@guerrillamail.com", "is_disposable": true }
Tool call: check_disposable_email
Input: { "email": "bob@gmail.com" }
Result: { "email": "bob@gmail.com", "is_disposable": false }
Tool call: check_disposable_email
Input: { "email": "charlie@yopmail.com" }
Result: { "email": "charlie@yopmail.com", "is_disposable": true }
Claude: "3 of 500 rows use disposable email providers:
Row 12: alice@guerrillamail.com (Guerrilla Mail)
Row 87: charlie@yopmail.com (YOPmail)
Row 341: dana@throwaway.email (Throwaway)
The rest look clean."
Para 500 linhas com 14 domínios exclusivos, Claude só precisa de 14 chamadas de API, pois desduplica por domínio. No nível gratuito (5 req/min), isso leva menos de três minutos. Com uma chave API, termina em segundos.
Caso de uso 3: verificação MX em nível de domínio
Às vezes você quer ir mais fundo do que a detecção descartável. Um endereço de e-mail pode ser sintaticamente válido e não descartável, mas o domínio pode não ter registros MX, o que significa que não pode receber e-mails. Peça a Claude para verificar os registros MX de cada domínio exclusivo da sua lista.
You: "Check the MX records for all unique domains in this email list."
Claude extracts 14 unique domains and calls dns_lookup for each:
Tool call: lookup_dns
Input: { "domain": "acme-corp.io", "type": "MX" }
Result:
{
"domain": "acme-corp.io",
"type": "MX",
"records": [
{ "value": "aspmx.l.google.com", "priority": 1, "ttl": 300 }
]
}
Tool call: lookup_dns
Input: { "domain": "defunct-startup.xyz", "type": "MX" }
Result:
{
"domain": "defunct-startup.xyz",
"type": "MX",
"records": []
}
Claude: "12 of 14 domains have valid MX records. Two domains
have no MX records and can't receive email:
- defunct-startup.xyz (0 MX records)
- old-agency.co (0 MX records)
Emails to these domains will bounce."
Isso captura domínios que expiraram, nunca foram configurados para email ou estão estacionados. Esses são endereços que serão rejeitados se você enviar para eles.
Como funciona
O servidor MCP em api.botoi.com/mcp expõe 44 ferramentas como funções que podem ser chamadas. Ao conectá-lo ao Claude, o cliente busca o manifesto da ferramenta na inicialização. Claude vê o nome, a descrição e o esquema de entrada de cada ferramenta.
Quando você pergunta sobre validação de e-mail, Claude seleciona a ferramenta certa com base na sua pergunta:
- Perguntas sobre um endereço de e-mail específico →
lookup_email - Perguntas sobre fornecedores descartáveis →
check_disposable_email - Perguntas sobre registros MX, SPF ou DMARC →
lookup_dns
Claude envia a solicitação, recebe de volta o JSON estruturado e interpreta o resultado no contexto. Nenhuma chave de API é necessária para o nível gratuito, com 5 solicitações por minuto e 100 por dia. Adicione uma chave no Authorization cabeçalho para limites mais altos.
Outras ferramentas MCP relacionadas a e-mail
A mesma conexão MCP dá acesso a estas ferramentas relacionadas:
lookup_email: validação completa incluindo sintaxe, formato, registros MX e detecção descartávelcheck_disposable_email: verificação focada para provedores descartáveis como Mailinator, Guerrilla Mail e YOPmaillookup_dns: consulte MX, SPF, DMARC e outros registros DNS para qualquer domíniodetect_pii: digitalize um bloco de texto e encontre endereços de e-mail (além de números de telefone, SSNs e outras PII) incorporados nele
Todos os quatro funcionam através do mesmo servidor MCP. Nenhuma configuração extra necessária.
Navegue pela lista completa de 44 ferramentas em api.botoi.com/v1/mcp/tools.json, ou visite o Página de configuração do MCP para configurações de cada cliente compatível.
FAQ
- Como valido um endereço de e-mail usando Claude e MCP?
- Conecte o servidor Botoi MCP ao Claude Desktop ou Claude Code e peça a Claude para verificar qualquer endereço de e-mail. Claude chama a ferramenta email_validate automaticamente, retornando validade do formato, status do registro MX e detecção de provedor descartável em segundos.
- Claude pode validar um lote de e-mails de um arquivo CSV?
- Sim. Peça ao Claude para ler seu arquivo CSV e sinalizar e-mails descartáveis ou inválidos. Claude percorre as linhas, chama a ferramenta descartável_email_check ou email_validate para cada endereço e relata quais linhas apresentam problemas.
- Quais ferramentas de validação de e-mail estão disponíveis no servidor Botoi MCP?
- Quatro ferramentas cobrem a validação de e-mail: email_validate (sintaxe, formato, MX, verificação descartável), descartável_email_check (detecta provedores descartáveis como Mailinator e Guerrilla Mail), dns_lookup (verificações de registro MX, SPF, DMARC) e pii_detect (encontra endereços de e-mail incorporados no texto).
- Preciso de uma chave de API para validar e-mails por meio do MCP?
- Não. O servidor Botoi MCP funciona sem chave de API a 5 solicitações por minuto e 100 por dia. For higher limits, get a free key for 1,000 requests per day or a paid plan starting at $9/month.
- Quais clientes MCP suportam validação de e-mail com Botoi?
- Claude Desktop, Claude Code, Cursor, VS Code e Windsurf suportam o servidor Botoi MCP. Adicione a URL do servidor (https://api.botoi.com/mcp) à configuração do seu cliente e comece a perguntar sobre endereços de e-mail.
Comece a construir com botoi
150+ endpoints de API para consultas, processamento de texto, geração de imagens e utilitários para desenvolvedores. Plano gratuito, sem cartão de crédito.