isBusinessEmail

Conecte Claude, ChatGPT, Cursor, VS Code e outros clientes MCP ao isBusinessEmail: URL do servidor, login OAuth, ferramentas, exemplos de prompts e limites.

Ver como Markdown

O isBusinessEmail executa um servidor MCP remoto (Model Context Protocol). Conecte-o uma vez, e seu assistente de IA pode verificar se um endereço é um e-mail de trabalho, classificar uma lista de leads ou descobrir se uma empresa usa Google Workspace ou Microsoft 365, usando sua conta e cota.

https://api.isbusinessemail.com/mcp

Transporte	HTTP Streamable (respostas JSON, sem sessões)
Login	OAuth 2.1 com PKCE, através da sua conta isBusinessEmail. Ou envie uma chave de API como token Bearer.
Custo	Grátis. Cada verificação conta para sua cota diária, como uma chamada de API.

Conecte seu assistente

Claude (web, desktop e mobile)

1. Abra Configurações → Conectores e escolha Adicionar conector personalizado.
2. Nomeie-o como isBusinessEmail e cole https://api.isbusinessemail.com/mcp como URL.
3. Selecione Conectar, faça login no isBusinessEmail (ou crie uma conta gratuita) e selecione Permitir acesso.

Nos planos Team e Enterprise, um proprietário adiciona o conector para a organização primeiro.

Claude Code

claude mcp add --transport http isbusinessemail https://api.isbusinessemail.com/mcp

Em seguida, execute /mcp dentro do Claude Code e escolha Autenticar. Uma janela do navegador abre para o login.

ChatGPT

Adicione um conector personalizado (no modo desenvolvedor, dependendo do seu plano) com a URL do servidor https://api.isbusinessemail.com/mcp e autenticação OAuth. O ChatGPT se registra e abre a página de login.

Cursor

~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "isbusinessemail": { "url": "https://api.isbusinessemail.com/mcp" }
  }
}

O Cursor mostra Needs login ao lado do servidor; selecione-o para fazer login.

VS Code

.vscode/mcp.json:

{
  "servers": {
    "isbusinessemail": { "type": "http", "url": "https://api.isbusinessemail.com/mcp" }
  }
}

Qualquer outro cliente, com uma chave de API

Se seu cliente não suporta OAuth, use uma chave secreta do seu painel como cabeçalho:

{
  "mcpServers": {
    "isbusinessemail": {
      "url": "https://api.isbusinessemail.com/mcp",
      "headers": { "Authorization": "Bearer ibe_live_your_key" }
    }
  }
}

Mantenha as chaves fora de repositórios compartilhados. Uma conexão OAuth é mais segura: ela cria sua própria chave que você pode revogar sem afetar suas outras integrações.

Ferramentas

Ferramenta	O que faz	Conta como
check_email	Classifica um endereço: categoria, is_business, recomendação, motivos, sugestão de erro de digitação, provedor de e-mail, Google Workspace / Microsoft 365	1 verificação
check_domain	O mesmo para um domínio, para quando você só se importa com a empresa	1 verificação
check_batch	Até 100 endereços ou domínios em uma chamada, resultados na ordem de entrada	1 verificação por item
get_usage	Nível, limites, verificações usadas e restantes hoje, últimos 30 dias	grátis
report_wrong_verdict	Relata um endereço ou domínio mal classificado; uma pessoa revisa	grátis (50 por dia)

As ferramentas de verificação aceitam um policy opcional (b2b, strict ou lenient; veja Categorias e políticas). Cada ferramenta retorna um resumo curto em texto para o assistente e a resposta completa da API como conteúdo estruturado, com os mesmos campos de POST /v1/check.

Coisas para perguntar

• “O jane@acme.io é um e-mail de trabalho? A Acme usa Google Workspace ou Microsoft 365?”
• “Aqui estão 40 inscrições desta semana. Quais são pessoais ou descartáveis?”
• “Pontue esses leads por domínio de e-mail e me diga quais enviar para vendas.”
• “Por que contoso.com foi classificado como empresarial? Mostre-me os motivos.”
• “Quantas verificações me restam hoje?”

Como funciona o login

O servidor segue a especificação de autorização MCP:

1. Sem token, /mcp responde a 401 com um cabeçalho WWW-Authenticate apontando para https://api.isbusinessemail.com/.well-known/oauth-protected-resource/mcp.
2. O cliente lê os metadados do servidor de autorização em https://api.isbusinessemail.com/.well-known/oauth-authorization-server e então se registra (registro dinâmico de cliente).
3. Você faz login em isbusinessemail.com e aprova o aplicativo. PKCE (S256) é obrigatório.
4. O aplicativo recebe uma chave secreta chamada MCP · . Ela aparece em suas chaves, com seu próprio uso. Revogue-a lá para desconectar o aplicativo. Conectar o mesmo aplicativo novamente substitui sua chave anterior.

Limites e privacidade

• As verificações MCP usam os limites de taxa e a cota diária da sua conta. Quando a cota é esgotada, as ferramentas retornam um erro quota_exceeded até 00:00 UTC.
• O servidor MCP vê os mesmos dados que a API: os endereços e domínios que seu assistente envia. Ele nunca envia e-mails nem faz sondagens. Veja Privacidade e dados.
• Seu assistente decide quando chamar uma ferramenta. A maioria dos clientes pergunta antes de executar ferramentas; verifique as configurações do seu cliente.

Solução de problemas

Sintoma	Correção
O cliente diz que o servidor precisa de autenticação	Conecte novamente e conclua o login no navegador.
“Esta conta já tem o número máximo de chaves de API ativas”	Revogue uma chave não utilizada em /app/keys e conecte novamente.
As ferramentas retornam quota_exceeded	Aguarde a redefinição às 00:00 UTC, ou peça mais.
As ferramentas retornam invalid_token	A chave foi revogada. Conecte novamente.