Referencia
TG Validator Referencia de MCP
El Model Context Protocol permite a las aplicaciones de IA llamar a herramientas externas durante una conversación. Pida a su asistente que verifique un número o revise un lote sin escribir una integración de API aparte.
MCP es un adaptador de protocolo. Usa los mismos productos, saldo, facturación, límites de concurrencia, tiempos de espera y semántica de resultados que la API REST.
Los productos, los precios y los límites figuran en la referencia de la API
Autenticación
Use exactamente la misma clave API que la API REST y añádala como token Bearer en la configuración de su cliente MCP.
Authorization: Bearer YOUR_API_KEYMantenga su clave API privadaAñada la clave solo a la configuración de su propio cliente de confianza. Nunca la exponga en código del navegador ni en prompts públicos.
URL del servidor
Apunte su cliente al endpoint oficial Streamable HTTP. No se necesita ningún proceso MCP local.
| Elemento | Valor |
|---|---|
| Endpoint MCP | https://tgvalidator.com/mcp |
| Streamable HTTP | Las solicitudes usan JSON-RPC sobre Streamable HTTP y el mismo middleware de claves API que REST. |
Conecte su cliente
Elija el formato de configuración que admita su cliente. Sustituya el marcador de posición por su clave API.
claude mcp add --transport http tgvalidator https://tgvalidator.com/mcp --header "Authorization: Bearer YOUR_API_KEY"Añada el servidor remoto desde su terminal.
Herramientas disponibles
Las herramientas se limitan a la aplicación a la que pertenece su clave API. Llame primero a list_products cuando necesite descubrir los códigos de producto válidos.
list_products
Enumera los productos, precios, multiplicadores de facturación y campos de respuesta.
Sin parámetroscheck_number
Verifica de forma síncrona un número E.164. registered es el resultado principal.
service_type · string · obligatorio
identifier · string · obligatoriocheck_numbers
Verifica de 1 a 100 números con un mismo service_type y conserva el orden de entrada.
service_type · string · obligatorio
identifiers · string[] · obligatorio · máx. 100get_balance
Consulta el saldo actual de la cuenta sin realizar ningún cargo.
Sin parámetrosEjemplos de prompts
Tras conectarse, pregunte a su asistente en lenguaje natural:
Comprueba si +17253100591 está registrado en Telegram.
Verifica estos 20 números y resume los resultados.
¿Cuánto saldo queda antes de ejecutar este lote?
Gestión de errores
Los fallos de las herramientas usan isError=true y el mismo contrato code, msg, data que la API.
Ejemplo de error de herramienta
{
"code": 42901,
"msg": "too many concurrent requests",
"data": null
}| Código | Descripción |
|---|---|
40000Producto o campo no válido | service_type no compatible o campos en conflicto. |
40002Número no válido | El número enviado no tiene un formato válido. |
40100Clave API ausente o no válida | Revise la cabecera Bearer y confirme que la clave está activa. |
40200Saldo insuficiente | La solicitud se rechaza antes de procesarse cuando no se puede cubrir el importe completo del lote. |
42200Indeterminado | No se ha podido determinar el número en este momento. No se devuelve ningún resultado y esta llamada no se cobra. |
42901Cupo de concurrencia completo | Las cinco plazas de solicitudes simultáneas están ocupadas o ya hay una verificación múltiple en ejecución en esta cuenta. No se cobra; reintente cuando termine una. |
50303Servicio a plena capacidad | Hay demasiadas verificaciones en curso en toda la plataforma. No se cobra; espere los segundos indicados en Retry-After y vuelva a enviarla. |
50400La verificación ha superado el tiempo de espera | No finalizó a tiempo. No se cobra; una verificación múltiple que supera el tiempo de espera falla en su totalidad y se reembolsa íntegramente. |
50300Mantenimiento del servicio | Inténtelo de nuevo más tarde. |