TeleSign MCP

Servidor MCP para Servicios TeleSign

Documentación

Servidor MCP de TeleSign

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una integración perfecta con las APIs de TeleSign para asistentes de IA como Claude de Anthropic, ChatGPT de OpenAI o Gemini de Google. Permite que tu IA envíe mensajes SMS, verifique números de teléfono, evalúe el riesgo de fraude y más.

¿Qué es MCP?

El Protocolo de Contexto de Modelo es un estándar abierto que permite a los asistentes de IA conectarse de forma segura a fuentes de datos y herramientas externas. Este servidor implementa MCP para dar a los asistentes de IA acceso directo a las APIs de comunicación y verificación de TeleSign.

🔨 Características

Herramientas Disponibles

Herramienta	Descripción
`verifyapi_send_otp`	Enviar un código de acceso de un solo uso por SMS, voz, WhatsApp, Viber, RCS o correo electrónico con soporte de respaldo automático
`verifyapi_check_code`	Verificar un código OTP ingresado por el usuario
`verifyapi_get_status`	Consultar el estado de una verificación en curso
`phoneid_get_info`	Obtener detalles del número de teléfono, incluidos tipo (móvil/fijo/VoIP), operador y ubicación
`intelligence_assess_risk`	Obtener puntuación de riesgo de fraude (0-1000) con recomendación de permitir/marcar/bloquear
`messaging_send_sms`	Enviar mensajes SMS (OTP, alertas o marketing)
`docs_search`	Buscar en la documentación de TeleSign
`docs_get`	Recuperar documentación completa para un tema

Capacidades Clave

Verificación OTP Multicanal - Enviar códigos de verificación por SMS, voz, WhatsApp, Viber, RCS o correo electrónico con respaldo automático entre canales
Inteligencia Telefónica - Identificar tipo de número de teléfono, operador y ubicación geográfica
Prevención de Fraude - Puntuación de riesgo en tiempo real para detectar números de teléfono fraudulentos
Mensajería SMS - Enviar mensajes transaccionales o de marketing
Documentación Integrada - Acceder a la documentación de la API de TeleSign directamente a través del asistente de IA

🛠️ Instalación

Requisitos Previos

Node.js 18+
Cursor, Claude Code, VSCode, Windsurf u otro Cliente MCP
Una cuenta de TeleSign con credenciales de API (Regístrate aquí)

Configuración

Clona el repositorio:

git clone https://github.com/mdp18/telesign-mcp.git
cd telesign-mcp

Instala las dependencias:
```
npm install
```
Compila el proyecto:
```
npm run build
```

Configuración

Variables de Entorno

Establece tus credenciales de la API de TeleSign:

export TELESIGN_CUSTOMER_ID="your-customer-id"
export TELESIGN_API_KEY="your-api-key"

Configuración de Claude Desktop

Agrega esto a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telesign": {
      "command": "node",
      "args": ["/path/to/telesign-mcp/build/index.js"],
      "env": {
        "TELESIGN_CUSTOMER_ID": "your-customer-id",
        "TELESIGN_API_KEY": "your-api-key"
      }
    }
  }
}

Ejemplos de Uso

Una vez configurado, puedes pedirle a Claude que:

"Envía un OTP al +15551234567 por SMS con respaldo de voz después de 30 segundos"
"Verifica el código 123456 para la referencia abc-123"
"Obtén información sobre el número de teléfono +15551234567"
"Consulta la puntuación de riesgo de fraude para +15551234567"
"Envía un SMS al +15551234567 diciendo 'Tu pedido ha sido enviado'"

📚 Documentación de la API

El servidor incluye documentación integrada accesible a través de las herramientas docs_search y docs_get. Temas disponibles:

verify-api - Endpoints y flujos de verificación OTP
phone-id - Detalles de consulta de números de teléfono
intelligence - Puntuación de riesgo y detección de fraude
messaging-sms - Guía de mensajería SMS
status-codes - Referencia de códigos de respuesta de la API

🤝 APIs Compatibles

Actualmente Funcionales

API de Verificación - Verificación OTP multicanal (SMS, voz, WhatsApp, Viber, RCS, correo electrónico) con soporte de respaldo
API de Phone ID - Inteligencia de números de teléfono con complementos de atributos de identidad (cambio de SIM, desactivación de número, información de contacto, historial de portabilidad, etc.)
API de Inteligencia - Puntuación de riesgo de fraude y recomendaciones
API de Mensajería - Envío básico de SMS (/v1/messaging)

Próximamente

💻 Desarrollo

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server directly
npm start

📄 Licencia

Apache 2.0 - Consulta LICENCIA para más detalles.

🛟 Soporte

⚠️ Aviso Legal

Este es un proyecto de código abierto impulsado por la comunidad y no está afiliado oficialmente, respaldado ni soportado por TeleSign. Los autores no poseen ni reclaman ningún derecho sobre la marca comercial, el nombre o la imagen de TeleSign. "TeleSign" y cualquier logotipo asociado son marcas comerciales de TeleSign Corporation.

Este proyecto se proporciona "tal cual" sin garantía de ningún tipo. Úsalo bajo tu propio riesgo. Para soporte oficial de TeleSign no relacionado con este servidor MCP, contacta directamente con TeleSign.