Referência

EmailCheckPro Referência do MCP

O Model Context Protocol permite que aplicativos de IA chamem ferramentas externas durante uma conversa. Peça ao seu assistente para verificar um e-mail ou analisar um lote sem escrever uma integração de API separada.

O MCP é um adaptador de protocolo. Ele usa os mesmos produtos, saldo, cobrança, limites de concorrência, tempos limite e semântica de resultados da API REST.

Produtos, preços e limites estão na referência da API

Autenticação

Use exatamente a mesma chave de API da API REST e adicione-a como token Bearer na configuração do seu cliente MCP.

Cabeçalho Authorization

Authorization: Bearer YOUR_API_KEY

Mantenha sua chave de API privadaAdicione a chave apenas à configuração do seu próprio cliente confiável. Nunca a exponha em código de navegador ou em prompts públicos.

URL do servidor

Aponte seu cliente para o endpoint oficial Streamable HTTP. Nenhum processo MCP local é necessário.

Item	Valor
Endpoint MCP	https://emailcheckpro.com/mcp
Streamable HTTP	As solicitações usam JSON-RPC sobre Streamable HTTP e o mesmo middleware de chave de API da REST.

Conecte seu cliente

Escolha o formato de configuração compatível com o seu cliente. Substitua o marcador pela sua chave de API.

claude mcp add --transport http emailcheckpro https://emailcheckpro.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Adicione o servidor remoto pelo seu terminal.

{
  "mcpServers": {
    "emailcheckpro": {
      "url": "https://emailcheckpro.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Adicione esta entrada de servidor à configuração MCP do cliente.

Ferramentas disponíveis

As ferramentas ficam restritas ao aplicativo ao qual sua chave de API pertence. Chame list_products primeiro quando precisar descobrir os códigos de produto válidos.

list_products

Lista produtos, preços, multiplicadores de cobrança e campos de resposta.

Parâmetros

Sem parâmetros

check_number

Verifica um e-mail de forma síncrona. registered é o resultado principal.

Parâmetros

service_type · string · obrigatório
identifier · string · obrigatório

check_numbers

Verifica de 1 a 100 e-mails com um único service_type e preserva a ordem de entrada.

Parâmetros

service_type · string · obrigatório
identifiers · string[] · obrigatório · máx. 100

get_balance

Lê o saldo atual da conta sem cobrá-lo.

Parâmetros

Sem parâmetros

Exemplos de prompts

Depois de conectar, peça ao seu assistente em linguagem natural:

Verifique se name@example.com é entregável — se pode receber mensagens.
Verifique estes 20 e-mails e resuma os resultados.
Quanto saldo ainda tenho antes de executar este lote?

Tratamento de erros

Falhas de ferramentas usam isError=true e o mesmo contrato code, msg, data da API.

Exemplo de erro de ferramenta

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}

Código	Descrição
`40000`Produto ou campo inválido	service_type não suportado ou campos conflitantes.
`40002`E-mail inválido	O e-mail enviado não está em um formato válido.
`40100`Chave de API ausente ou inválida	Verifique o cabeçalho Bearer e confirme se a chave está ativa.
`40200`Saldo insuficiente	A solicitação é rejeitada antes do processamento quando o valor total do lote não pode ser coberto.
`42200`Indeterminado	Não foi possível determinar o e-mail neste momento. Nenhum resultado é retornado e esta chamada não é cobrada.
`42901`Cota de concorrência esgotada	Todas as cinco vagas de solicitações simultâneas estão ocupadas ou já há uma verificação múltipla em execução nesta conta. Sem cobrança; tente novamente quando uma terminar.
`50303`Serviço no limite da capacidade	Há verificações demais em andamento em toda a plataforma. Sem cobrança; aguarde os segundos de Retry-After e reenvie.
`50400`Tempo da verificação esgotado	Não terminou a tempo. Sem cobrança; uma verificação múltipla que excede o tempo falha por completo e é reembolsada integralmente.
`50300`Manutenção do serviço	Tente novamente mais tarde.