Referência

TG Validator 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 número ou revisar 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 simultaneidade, 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://tgvalidator.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 seu cliente. Substitua o marcador pela sua chave de API.

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

Adicione o servidor remoto pelo seu terminal.

{
  "mcpServers": {
    "tgvalidator": {
      "url": "https://tgvalidator.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 número E.164 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 números 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á-la.

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 Telegram.
Verifique estes 20 números e resuma os resultados.
Quanto saldo ainda tenho antes de executar este lote?

Tratamento de erros

As falhas de ferramenta 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`Número inválido	O número 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 número 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.