MCP de Consulta da operadora original: Usando a Consulta da operadora em assistentes de IA
Saiba como o endpoint MCP de consulta da operadora permite que assistentes de IA verifiquem a operadora original e o tipo de linha, e como funcionam as tarefas.
Um guia prático para conectar um assistente de IA ao endpoint MCP do CarrierLookup para consultas em tempo real da operadora original.
Uma integração MCP de consulta da operadora permite que um assistente de IA chame uma consulta de operadora de telefone como uma ferramenta, em vez de uma pessoa copiar números para um painel. O CarrierLookup disponibiliza um endpoint MCP oficial em tempo real em https://carrierlookup.online/mcp. Ele lista produtos, verifica um número, verifica um lote de números e lê o saldo da conta. Os resultados descrevem a operadora à qual um número foi originalmente alocado, não a operadora atual após a portabilidade. Tarefas de arquivos grandes não estão disponíveis via MCP.
O que um endpoint MCP de consulta da operadora faz
O Model Context Protocol (MCP) é uma maneira padrão para um assistente de IA descobrir e chamar ferramentas externas. A busca por um MCP de consulta da operadora hoje retorna principalmente dois grupos não relacionados: servidores de transportadoras de carga que consultam registros de autoridade de transporte e servidores de números de telefone. Alguns servidores de telefone são scripts locais limitados a um país; outros, como a listagem da Data247, são serviços remotos que retornam dados de operadoras dos EUA e Canadá. Verifique que tipo de servidor é antes de conectá-lo.
O endpoint do CarrierLookup pertence ao grupo de números de telefone e tem escopo global para consultas em tempo real. Ele opera sobre o mesmo serviço que o painel da Web e a API REST, portanto, o assistente usa a mesma conta, saldo, faturamento e limites que um usuário humano.
O hábito principal é ler os resultados como contexto de alocação. O valor da operadora é aquele ao qual a faixa numérica foi originalmente alocada. Se um número mudou para outra rede, a operadora original ainda aparece, portanto, um assistente nunca deve descrevê-la como a rede que atende o número atualmente.
Ferramentas expostas através do endpoint MCP
O endpoint expõe quatro ferramentas em tempo real, e apenas estas:
| Ferramenta | Use para |
|---|---|
| Lista de produtos | Descobrir qual serviço de consulta a conta pode chamar |
| check_number | Um número em formato internacional |
| check_numbers | Vários números em uma solicitação síncrona, retornados na ordem de entrada |
| get_balance | Ler o saldo compartilhado sem executar uma consulta |
A entrada segue a mesma regra da API REST: um sinal de mais inicial, o código do país e o número do assinante, sem espaços ou separadores. Consultas em tempo real não precisam de uma seleção de país separada, portanto, uma lista de vários países pode ser processada em uma única solicitação múltipla.
Quando o assistente verifica vários números, cada linha na resposta contém o número e se um resultado normal existe. Uma linha que relata que não há resultado significa que não houve um resultado normal para aquele número. Isso não significa que o número esteja desconectado ou inválido, e um resumo do assistente deve dizer exatamente isso, em vez de supor.
Uma consulta concluída ainda pode retornar campos opcionais vazios. Isso é uma verificação finalizada com poucos dados de alocação, não uma falha.
Conectando um assistente com segurança
O endpoint MCP autentica com um cabeçalho Authorization contendo um token Bearer. A API REST, por outro lado, usa um cabeçalho X-API-Key de um servidor confiável. Mantenha os dois distintos ao alternar entre integrações e mantenha as credenciais no armazenamento secreto do cliente do assistente, em vez de em prompts ou logs de chat compartilhados.
Como o MCP compartilha o saldo da conta, um assistente que percorre uma longa lista consumirá o saldo à medida que avança. Guardrails úteis:
- Peça ao assistente para chamar get_balance antes de um lote interativo grande e informar o resultado.
- Mantenha cada solicitação múltipla em um tamanho que uma pessoa possa revisar. A chamada múltipla síncrona aceita de 1 a 100 números.
- Diga ao assistente para relatar falhas separadamente de resultados vazios, já que consultas falhas ou Indeterminado não geram cobrança, enquanto uma consulta concluída gera.
- Revise as primeiras linhas manualmente antes de confiar em um resumo.
Uma solicitação múltipla que atinge o tempo limite falha como um todo, sem resultados parciais, portanto, o assistente deve tentar novamente o mesmo grupo menor em vez de unir saídas parciais.
Onde o MCP se encaixa e onde não se encaixa
O MCP é adequado para trabalhos conversacionais de pequeno a médio porte: um analista pede a um assistente para enriquecer alguns leads, um agente de suporte verifica um número durante um ticket ou um desenvolvedor verifica como os resultados aparecem antes de escrever o código de integração. A resposta retorna dentro da conversa, portanto, nenhuma etapa de exportação é necessária.
É a ferramenta errada para listas preparadas grandes. O serviço de arquivo assíncrono, Consulta da operadora original, é executado através do painel ou dos endpoints de tarefa em lote da API REST, que aceitam arquivos TXT ou CSV para um país selecionado e retornam um CSV para download por tarefa bem-sucedida. Não há ferramenta de arquivo em lote no MCP, e uma solicitação múltipla é uma verificação síncrona, não uma tarefa de arquivo.
Uma regra de decisão simples funciona bem: se os números cabem em uma conversa e a resposta é necessária agora, use o MCP; se a lista é um arquivo, use uma tarefa em lote; se um sistema de produção precisa disso, chame a API REST de um servidor confiável.
Independentemente do canal, os dados da operadora informam o roteamento e o agrupamento de CRM. Eles não estabelecem que um número pode receber chamadas ou mensagens, quem o possui ou se o contato consentiu com o contato.
FAQ
Um assistente de IA pode executar tarefas de arquivo em lote através do endpoint MCP de consulta da operadora?
Não. O endpoint MCP cobre apenas o trabalho em tempo real: listar produtos, verificar um número, verificar um grupo de números e ler o saldo. Tarefas de arquivo para listas grandes são executadas através do painel ou dos endpoints REST de tarefa em lote, e o resultado é um CSV para download.
Como as equipes podem autenticar um assistente no endpoint MCP?
O endpoint MCP usa um cabeçalho Authorization com um token Bearer, enquanto a API REST usa um cabeçalho X-API-Key de um servidor confiável. Armazene a credencial nas configurações secretas do cliente e nunca a cole em um prompt ou documento compartilhado.
A consulta MCP retorna a operadora que um número usa hoje?
Não. A operadora é aquela à qual a faixa numérica foi originalmente alocada, o que pode diferir da rede atual após a portabilidade. Os assistentes devem apresentá-la apenas como contexto de alocação original e manter os resumos livres de declarações sobre o status da rede ou alcançabilidade.
Saiba mais
Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.