WA Lookup Referência do MCP

O Model Context Protocol é um padrão aberto que permite que aplicativos de IA chamem ferramentas externas durante uma conversa. Depois de conectado, você pode pedir ao seu assistente que verifique um número ou revise um lote sem escrever uma integração de API separada.

O MCP é um adaptador de protocolo, não um sistema de validação separado. 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 que você usa na API REST. Crie ou copie a chave em Configurações 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 cole em um prompt público, não a envie para o controle de versão nem a exponha em código do navegador.

URL do servidor

O servidor usa o transporte oficial Streamable HTTP. Aponte seu cliente para este único endpoint; nenhum processo MCP local é necessário.

ItemValor
Endpoint MCPhttps://walookup.com/mcp
Streamable HTTPAs solicitações usam JSON-RPC sobre Streamable HTTP e são autenticadas pelo mesmo middleware de chave de API dos endpoints REST.

Conecte seu cliente

Oferecemos suporte a Claude Code, Cursor / Claude Desktop e qualquer outro cliente MCP compatível com Streamable HTTP. Escolha a aba correspondente abaixo e substitua o marcador pela sua chave de API.

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

Adicione o servidor remoto pelo seu terminal.

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 os produtos disponíveis para esta chave de API, incluindo preços, multiplicadores de cobrança, finalidades e campos de resposta.

Parâmetros
Sem parâmetros

check_number

Verifica um número enviado de forma síncrona. registered é o resultado principal; avatar e business são campos opcionais do produto.

Parâmetros
service_type · string · obrigatório
identifier · string · obrigatório

check_numbers

Verifica de 1 a 100 números com um único service_type. Os resultados preservam a ordem de entrada; cada número é avaliado de forma independente e um número com falha não interrompe os demais.

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

get_balance

Lê o saldo atual da conta. É somente leitura e não cria uma verificação nem cobra a conta.

Parâmetros
Sem parâmetros

Exemplos de prompts

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

  • Verifique se +17253100591 está registrado no WhatsApp.
  • Verifique estes 20 números e resuma os resultados de registrados e não registrados.
  • Mostre os produtos disponíveis para minha chave de API e seus preços.
  • Quanto saldo ainda tenho antes de executar este lote?

Tratamento de erros

As falhas das ferramentas são retornadas com isError=true para que o cliente possa explicar o que aconteceu em vez de tratar a conexão como interrompida. As falhas de negócio usam o mesmo contrato code, msg, data da API.

Exemplo de erro de ferramenta

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}
CódigoDescrição
40000Produto ou campo inválidoservice_type não suportado ou campos conflitantes.
40002Número inválidoO número enviado não está em um formato válido.
40100Chave de API ausente ou inválidaVerifique o cabeçalho Bearer e confirme se a chave está ativa.
40200Saldo insuficienteA solicitação é rejeitada antes do processamento quando o valor total do lote não pode ser coberto.
42200IndeterminadoNão foi possível determinar o número neste momento. Nenhum resultado é retornado e esta chamada não é cobrada.
42901Cota de concorrência esgotadaTodas 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.
50303Serviço no limite da capacidadeHá verificações demais em andamento em toda a plataforma. Sem cobrança; aguarde os segundos de Retry-After e reenvie.
50400Tempo da verificação esgotadoNão terminou a tempo. Sem cobrança; uma verificação múltipla que excede o tempo falha por completo e é reembolsada integralmente.
50300Manutenção do serviçoTente novamente mais tarde.