Carrier Lookup MCP: Uso de la Consulta del operador original en asistentes de IA
Descubra cómo el endpoint MCP de Carrier Lookup permite a los asistentes de IA verificar el operador original y el tipo de línea, y qué tareas requieren archivos.
Una guía práctica para conectar un asistente de IA al endpoint MCP de CarrierLookup para realizar consultas en tiempo real sobre el operador original.
Una integración de Carrier Lookup mediante MCP permite que un asistente de IA invoque una consulta de operador telefónico como una herramienta, en lugar de que una persona copie números manualmente en un panel de control. CarrierLookup expone un endpoint MCP oficial en tiempo real en https://carrierlookup.online/mcp. Este permite listar productos, consultar un número, verificar un grupo de números y leer el saldo de la cuenta. Los resultados describen el operador al que se asignó originalmente un número, no el operador actual tras una portabilidad. Las tareas con archivos grandes no están disponibles a través de MCP.
Qué hace un endpoint MCP de Carrier Lookup
El Model Context Protocol (MCP) es un estándar que permite a un asistente de IA descubrir e invocar herramientas externas. La búsqueda de un MCP de consulta de operador hoy en día arroja principalmente dos grupos no relacionados: servidores de transporte de carga que consultan registros de autoridad de transporte, y servidores de números telefónicos. Algunos servidores telefónicos son scripts locales limitados a un solo país; otros, como el listado de Data247, son servicios remotos que devuelven datos de operadores de EE. UU. y Canadá. Verifique qué tipo de servidor es antes de conectarlo.
El endpoint de CarrierLookup pertenece al grupo de números telefónicos y tiene un alcance global para consultas en tiempo real. Se basa en el mismo servicio que el panel web y la API REST, por lo que el asistente utiliza la misma cuenta, saldo, facturación y límites que un usuario humano.
La regla clave es interpretar los resultados como contexto de asignación. El valor del operador es aquel al que se asignó originalmente el rango del número. Si un número se trasladó a otra red, el operador original sigue apareciendo, por lo que un asistente nunca debe describirlo como la red que actualmente presta servicio al número.
Herramientas expuestas a través del endpoint MCP
El endpoint expone cuatro herramientas en tiempo real, y solo estas:
| Herramienta | Úsela para |
|---|---|
| Lista de productos | Descubrir qué servicio de consulta puede invocar la cuenta |
| check_number | Un número en formato internacional |
| check_numbers | Varios números en una solicitud síncrona, devueltos en el orden de entrada |
| get_balance | Leer el saldo compartido sin ejecutar una consulta |
La entrada sigue la misma regla que la API REST: un signo más inicial, el código de país y el número de suscriptor, sin espacios ni separadores. Las consultas en tiempo real no necesitan una selección de país por separado, por lo que una lista de varios países puede procesarse en una sola solicitud múltiple.
Cuando el asistente verifica varios números, cada fila en la respuesta contiene el número y si existe un resultado normal. Una fila que informa que no hay resultado significa que no hubo un resultado normal para ese número. Esto no significa que el número esté desconectado o sea inválido, y el resumen del asistente debe indicar exactamente eso en lugar de realizar suposiciones.
Una consulta completada aún puede devolver campos opcionales vacíos. Se trata de una verificación finalizada con pocos datos de asignación, no de un fallo.
Conexión segura de un asistente
El endpoint MCP se autentica con un encabezado Authorization que lleva un token Bearer. La API REST, por el contrario, utiliza un encabezado X-API-Key de un servidor de confianza. Mantenga ambos conceptos separados al cambiar entre integraciones y guarde las credenciales en el almacenamiento seguro del cliente del asistente en lugar de en prompts o registros de chat compartidos.
Debido a que MCP comparte el saldo de la cuenta, un asistente que realice bucles sobre una lista larga consumirá saldo a medida que avance. Guardarraíles útiles:
- Pida al asistente que llame a get_balance antes de un lote interactivo grande y que informe del resultado.
- Mantenga cada solicitud múltiple en un tamaño que una persona pueda revisar. La llamada múltiple síncrona acepta de 1 a 100 números.
- Indique al asistente que informe de los fallos por separado de los resultados vacíos, ya que las consultas fallidas o Indeterminadas no descuentan saldo, mientras que una consulta completada sí lo hace.
- Revise manualmente las primeras filas antes de confiar en un resumen.
Una solicitud múltiple que agota el tiempo de espera falla en su totalidad sin resultados parciales, por lo que el asistente debe reintentar el mismo grupo más pequeño en lugar de unir salidas parciales.
Dónde encaja MCP y dónde no
MCP es adecuado para trabajos conversacionales de tamaño pequeño a mediano: un analista pide a un asistente que enriquezca un puñado de clientes potenciales, un agente de soporte verifica un número durante un ticket, o un desarrollador verifica cómo se ven los resultados antes de escribir el código de integración. La respuesta llega dentro de la conversación, por lo que no se necesita un paso de exportación.
Es la herramienta incorrecta para listas grandes preparadas. El servicio de archivos asíncrono, Consulta del operador original, se ejecuta a través del panel de control o de los endpoints de tareas masivas de la API REST, los cuales aceptan archivos TXT o CSV para un país seleccionado y devuelven un CSV descargable por cada tarea exitosa. No existe una herramienta de archivos masivos en MCP, y una solicitud múltiple es una verificación síncrona, no una tarea de archivo.
Una regla de decisión simple funciona bien: si los números caben en una conversación y la respuesta se necesita al momento, use MCP; si la lista es un archivo, use una tarea masiva; si un sistema de producción lo necesita, llame a la API REST desde un servidor de confianza.
Independientemente del canal, los datos del operador informan sobre el enrutamiento y la agrupación en el CRM. No establecen que un número pueda recibir llamadas o mensajes, quién es su propietario o si el contacto dio su consentimiento para recibir comunicaciones.
Preguntas frecuentes
¿Puede un asistente de IA ejecutar tareas de archivos masivos a través del endpoint MCP de Carrier Lookup?
No. El endpoint MCP cubre solo el trabajo en tiempo real: listar productos, consultar un número, verificar un grupo de números y leer el saldo. Las tareas de archivos para listas grandes se ejecutan a través del panel de control o de los endpoints REST de tareas masivas, y el resultado es un CSV descargable.
¿Cómo pueden los equipos autenticar a un asistente en el endpoint MCP?
El endpoint MCP utiliza un encabezado Authorization con un token Bearer, mientras que la API REST utiliza un encabezado X-API-Key de un servidor de confianza. Guarde la credencial en la configuración segura del cliente y nunca la pegue en un prompt o en un documento compartido.
¿La consulta MCP devuelve el operador que utiliza un número hoy en día?
No. El operador es aquel al que se asignó originalmente el rango del número, lo cual puede diferir de la red actual tras una portabilidad. Los asistentes deben presentarlo solo como contexto de asignación original y mantener los resúmenes libres de declaraciones sobre el estado de la red o la disponibilidad.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.