Referência
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.
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.
Authorization: Bearer YOUR_API_KEYMantenha 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.
| Item | Valor |
|---|---|
| Endpoint MCP | https://walookup.com/mcp |
| Streamable HTTP | As 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.
Sem parâmetroscheck_number
Verifica um número enviado de forma síncrona. registered é o resultado principal; avatar e business são campos opcionais do produto.
service_type · string · obrigatório
identifier · string · obrigatóriocheck_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.
service_type · string · obrigatório
identifiers · string[] · obrigatório · máx. 100get_balance
Lê o saldo atual da conta. É somente leitura e não cria uma verificação nem cobra a conta.
Sem parâmetrosExemplos 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ódigo | Descrição |
|---|---|
40000Produto ou campo inválido | service_type não suportado ou campos conflitantes. |
40002Número inválido | O número enviado não está em um formato válido. |
40100Chave de API ausente ou inválida | Verifique o cabeçalho Bearer e confirme se a chave está ativa. |
40200Saldo insuficiente | A solicitação é rejeitada antes do processamento quando o valor total do lote não pode ser coberto. |
42200Indeterminado | Não foi possível determinar o número neste momento. Nenhum resultado é retornado e esta chamada não é cobrada. |
42901Cota 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. |
50303Serviç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. |
50400Tempo 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. |
50300Manutenção do serviço | Tente novamente mais tarde. |