Wavix

oficial

Wavix es una plataforma de comunicaciones global que ofrece APIs para voz, SMS, 2FA y números telefónicos. Nuestro servidor MCP integra estas capacidades en agentes de IA y flujos de trabajo agentivos.

GitHub

Prueba este MCPPatrocinado

¿Qué puedes hacer con Wavix MCP?

Enviar SMS/MMS transaccionales — Solicita el envío de un mensaje mediante sms_and_mms_messages_send, que devuelve el ID del mensaje y el estado de entrega.
Ejecutar flujos de verificación 2FA — Crea un código con two_fa_verification_create y luego valídalo con two_fa_verification_check.
Buscar y comprar números de teléfono — Encuentra números disponibles con buy_numbers_list, agrégalos al carrito con cart_add y completa la compra con cart_checkout.
Buscar transcripciones de llamadas — Usa cdrs_search para encontrar llamadas por palabras clave de transcripción y luego enriquece los resultados con cdrs_get.
Descargar y transcribir grabaciones — Obtén una grabación con call_recording_get, solicita la transcripción con cdrs_retranscribe y recupera los resultados con cdrs_transcription_get.
Auditar facturación y recibos — Revisa los gastos con billing_transactions_list y descarga los PDF de facturas con billing_invoices_download.

Documentación

Servidor MCP de Wavix

Un servidor de Model Context Protocol que brinda a los LLM y agentes de IA acceso directo a la plataforma de telecomunicaciones Wavix: SMS/MMS, llamadas de voz, 2FA, troncales SIP, gestión de números de teléfono, registro 10DLC, grabaciones de llamadas, análisis de voz y facturación.

Wavix es una plataforma global de comunicaciones para enviar SMS, realizar llamadas de voz y ejecutar flujos 2FA a través de una única API. Hay una prueba gratuita disponible; el uso de pago sigue el plan de precios de Wavix asociado a tu cuenta.

La forma más rápida de usar este servidor MCP es el endpoint alojado en https://mcp.wavix.com/mcp: apunta cualquier cliente compatible con MCP hacia él y autentícate con tu clave API de Wavix. Si necesitas alojarlo tú mismo (implementación personalizada de Wavix, detrás de un firewall, instancia dedicada), consulta Ejecuta el tuyo.

Tabla de contenidos

Endpoint
Instalación — un clic, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Ejecuta el tuyo (autoalojado)
Ejemplos
Herramientas → catálogo completo en TOOLS.md
Recursos
Autenticación (mejores prácticas, si un token se ve comprometido)
Solución de problemas
Compatibilidad y límites
Soporte, Contribuciones, Seguridad, Licencia

Endpoint

Campo	Valor
URL	`https://mcp.wavix.com/mcp`
Transporte	Streamable HTTP
Auth	`Authorization: Bearer <api_key>`
Herramientas	ver TOOLS.md
Recursos	Documentación de Wavix + especificación OpenAPI (autodetectada)

Obtén una clave API de Wavix desde Consola de Wavix → Administración → Claves API → Crear nueva.

Instalación

Antes de empezar: consigue tu clave API de Wavix.

Inicia sesión en https://wavix.com.
Abre Administración → Claves API.
Haz clic en Crear nueva (o copia una clave existente). Tenla a mano: la pegarás en lugar de YOUR_API_KEY a continuación.

Instalación de un clic

⚠️ Los botones siguientes siembran la configuración MCP de tu editor con un token de marcador YOUR_API_KEY. Después de que el editor termine de instalar, abre la configuración generada y reemplaza el marcador con tu clave API real antes de enviar cualquier solicitud; de lo contrario, cada llamada devolverá 401 Unauthorized.

Para eliminar más tarde: abre el mismo archivo de configuración (~/.cursor/mcp.json, .vscode/mcp.json o el equivalente para tu editor) y elimina la entrada wavix, o quita el conector a través de la interfaz de MCP / Conectores de tu editor.

Claude Code

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

Usa claude mcp list para verificar y /mcp dentro de una sesión para ver el estado.

Claude Desktop / Claude Web

Configuración → Conectores → Agregar conector personalizado:

Nombre: Wavix
URL: https://mcp.wavix.com/mcp
Transporte: Streamable HTTP
Encabezado de autenticación: Authorization: Bearer <api_key>

Cursor (manual)

Agrega a ~/.cursor/mcp.json (o a nivel de proyecto .cursor/mcp.json):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ expone el catálogo completo; las versiones anteriores lo limitan a 40.

VS Code (manual, GitHub Copilot Chat)

Crea .vscode/mcp.json en tu espacio de trabajo (o agrega el mismo objeto servers bajo la clave "mcp" en settings.json de usuario):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Consulta la guía de servidores MCP de VS Code para conocer el esquema actualizado.

Codex CLI

Codex CLI es compatible con MCP a través de stdio. Conéctate al servidor alojado mediante mcp-remote. Edita ~/.codex/config.toml:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / otros clientes

Cualquier cliente MCP que admita transporte Streamable HTTP con encabezados personalizados funcionará. Usa:

URL: https://mcp.wavix.com/mcp
Encabezado: Authorization: Bearer <api_key>

¿Configurando mediante un agente de IA? Apunta tu agente a llms-install.md: es una guía de instalación legible por máquina que le proporciona al modelo la URL, el encabezado y la configuración por cliente en un formato determinista, para que no improvise valores de endpoint.

Ejecuta el tuyo

El servidor alojado funciona sin configuración adicional para la mayoría de los usuarios. Autoalójalo si necesitas apuntar a una implementación de Wavix no pública, ejecutarlo detrás de un firewall u operar dentro de tu propia infraestructura.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

El servidor escucha en el puerto 8000 y expone el endpoint MCP en /mcp. Apunta tu cliente a http://<host>:8000/mcp.

Desde el código fuente

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Requiere Python 3.10+.

Configuración

Variable de entorno	Predeterminado	Propósito
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Anula el endpoint de API de Wavix ascendente (para implementaciones internas o de prueba)

No se requieren credenciales de Wavix para ejecutar el servidor: se reenvían por solicitud desde el encabezado Authorization: Bearer <api_key> del cliente MCP. Quien autoaloje es responsable de terminar TLS frente al servidor (nginx, Caddy, balanceador de carga en la nube) antes de exponerlo públicamente.

Ejemplos

Indicaciones concretas que puedes usar en cualquier cliente conectado.

Los números de teléfono a continuación (+1 310 555 0100, +44 7700 900123) están en rangos de prueba reservados (NANP 555 y Ofcom 070 09xx): es seguro copiarlos tal cual; no se puede llegar a suscriptores reales a través de ellos.

Enviar un SMS transaccional

Indicación: "Envía un SMS desde +13105550100 a +447700900123 que diga 'Tu código de verificación es 4821'."

El agente llama a sms_and_mms_messages_send con from, to y text. Devuelve el ID del mensaje y el estado de entrega.

Ejecutar una verificación 2FA

Indicación: "Envía un código de verificación 2FA a +13105550100 por SMS. Cuando te dé el código que reciba, verifica si es correcto."

El agente llama a two_fa_verification_create, espera a que compartas el código que llega por SMS y luego llama a two_fa_verification_check. Útil para prototipar flujos sin contraseña sin escribir código de integración.

Encontrar y comprar un número de teléfono

Indicación: "Encuentra un número gratuito de EE. UU. disponible con capacidad SMS, agrégalo a mi carrito y finaliza la compra."

El agente encadena buy_numbers_list (filtrando por país y funcionalidad), cart_add y cart_checkout. Confirma con el usuario antes del pago: se cargará a la cuenta.

Buscar transcripciones de llamadas

Indicación: "Muéstrame todas las llamadas entrantes de ayer de más de dos minutos en las que el llamante mencionó 'reembolso'."

El agente usa cdrs_search sobre las transcripciones y luego enriquece cada resultado mediante cdrs_get para obtener los metadatos completos de la llamada.

Descargar una grabación y transcribirla

Indicación: "Obtén la grabación de la llamada abc-123, pide a Wavix que la transcriba y devuelve la transcripción."

El agente llama a call_recording_get (devuelve una URL de descarga pre-firmada), cdrs_retranscribe y luego consulta cdrs_transcription_get.

Auditar facturación

Indicación: "¿Cuánto gastamos en SMS el mes pasado? Dame un enlace de descarga para el PDF de la factura más reciente."

El agente llama a billing_transactions_list filtrado por tipo y fecha, y luego billing_invoices_list + billing_invoices_download. La herramienta de descarga devuelve una URL pre-firmada al PDF, no el archivo en sí: abre la URL en un navegador o pásala a tu cliente para obtener el documento real.

Herramientas

122 herramientas, generadas a partir de la especificación OpenAPI de Wavix. Los argumentos reflejan los parámetros de solicitud y los campos del cuerpo.

Grupo	#	Cobertura
SMS y MMS	10	Enviar, listar, recuperar mensajes; IDs de remitente; exclusiones
Control de llamadas	9	Iniciar / responder / finalizar llamadas; reproducir audio; recopilar DTMF
Grabación de llamadas	4	Listar, descargar (URL pre-firmada), eliminar
Transmisión de llamadas	2	Iniciar / detener transmisión de medios
Webhooks de llamadas	3	Listar, crear, eliminar
CDR	7	Listar, exportar, recuperar; búsqueda en transcripciones y retranscripción
Análisis de voz	4	Subir, transcribir, recuperar archivo original
2FA	6	Crear / verificar / cancelar / reenviar verificación; eventos
Mis números	6	Listar, actualizar, liberar; enrutamiento SMS / voz; carga de documentos
Comprar	5	Países, regiones, ciudades; búsqueda de números disponibles
Carrito	4	Agregar, eliminar, recuperar, finalizar compra
Validador de números	3	Validación individual y masiva
Troncales SIP	5	CRUD completo
10DLC	30	Marcas, campañas, verificación, evidencia, suscripciones a eventos
Perfil	3	Obtener / actualizar perfil; configuración de cuenta
Claves API	4	Listar, crear, activar / desactivar, eliminar
Subcuentas	5	Listar, crear, obtener, actualizar; transacciones
Facturación	3	Transacciones, facturas, descarga de estados de cuenta
Campañas de voz	2	Disparar y recuperar
Wavix Embeddable (WebRTC)	5	CRUD de tokens de widget
Acortador de enlaces	2	Crear enlaces cortos; métricas

Consulta TOOLS.md para ver la lista completa de herramientas con descripciones de una línea. La fuente autoritativa es la especificación OpenAPI de Wavix: tu cliente siempre verá el catálogo en vivo actual.

Recursos

Además de las herramientas, el servidor expone la documentación de Wavix como Recursos MCP, para que el modelo pueda obtener contexto autoritativo bajo demanda en lugar de adivinar a partir de conocimientos previos.

Esquema de URI	Contenido
`wavix://docs/<path>`	Páginas de documentación de docs.wavix.com (autodetectadas mediante `llms.txt`).
`wavix://api/openapi.yaml`	La especificación completa OpenAPI 3.0 de Wavix.

Ambas fuentes — docs.wavix.com y la especificación OpenAPI de Wavix — están disponibles públicamente y pueden consultarse directamente sin autenticación.

Los recursos se obtienen de forma diferida en resources/read y se almacenan en caché en el servidor con un TTL de 1 hora. El token Bearer ascendente nunca se reenvía a los hosts de documentación, solo a api.wavix.com.

Autenticación

Cada solicitud del cliente debe incluir:

Authorization: Bearer <api_key>

El servidor reenvía este encabezado a api.wavix.com por solicitud. El token:

nunca se registra en logs,
nunca se reenvía en redirecciones entre hosts (p. ej., URL de descarga S3 pre-firmadas),
nunca se envía a los hosts de documentación.

Si tu cliente sigue una URL de descarga pre-firmada devuelta por call_recording_get, billing_invoices_download, speech_analytics_file_get o ten_dlc_brand_evidence_get, obténla directamente sin el encabezado Authorization.

Mejores prácticas

Usa una clave API dedicada para MCP. Crea una clave API separada en https://wavix.com → Administración → Claves API (o mediante la propia herramienta api_keys_create, desde otra sesión). Esto te permite revocar el acceso MCP sin interrumpir otras integraciones.
Rota periódicamente. Trata la clave API como cualquier secreto de producción: rótala según un calendario y ante cualquier sospecha de fuga.
Mantén las claves API fuera de git. Las configuraciones de clientes MCP son fáciles de confirmar por accidente, llevando el token al historial y a los logs de CI. La mayoría de los clientes admiten sustitución de ${env:VAR} en el valor del encabezado: guarda la clave API en una variable de entorno o en el llavero de tu sistema operativo y refiérela desde la configuración. Como red de seguridad, agrega las rutas comunes de configuración de clientes a tu .gitignore del proyecto:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Si un token se ve comprometido

En la consola de Wavix, desactiva la clave inmediatamente (o llama a api_keys_deactivate).
Crea un reemplazo mediante api_keys_create o la consola.
Actualiza la configuración del cliente y vuelve a conectar.
Revisa billing_transactions_list y cdrs_list para detectar actividad inesperada.

Solución de problemas

Síntoma	Causa probable / solución
`401 Unauthorized` de cualquier herramienta	Falta el encabezado `Authorization: Bearer …` o no es válido. Verifica que la clave de API esté activa en la consola de Wavix.
La herramienta devuelve un `download_url`, no el archivo en sí	Es lo esperado. Los endpoints de grabaciones, facturas, análisis de voz y evidencia 10DLC devuelven URL prefirmadas (consulta Autenticación). Obtén la URL directamente sin el encabezado `Authorization`.
El cliente solo muestra ~40 herramientas, no el catálogo completo	Los clientes más antiguos aplican un límite de herramientas por servidor. Actualiza (Cursor 2.4+, VS Code más reciente, Claude más reciente).
`Tool not found` para una herramienta listada en este README	El cliente local puede estar almacenando en caché una lista de herramientas antigua. Reinicia el cliente o elimina y vuelve a añadir el servidor.
4xx con un array `errors`	Error de validación de la API de Wavix. Inspecciona `errors`; consulta la página relevante de `wavix://docs/*` o la especificación OpenAPI.
No se puede llegar al servidor	Confirma el DNS y el HTTPS de salida hacia `mcp.wavix.com:443`.
El agente llama a una herramienta destructiva inesperadamente	La mayoría de los clientes pueden requerir confirmación antes de las llamadas a herramientas: activa esa opción y rota a una clave de API MCP dedicada (consulta Mejores prácticas).

Compatibilidad y límites

Compatible con cualquier cliente MCP que admita el transporte Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDK de MCP personalizados) y con cualquier framework de agentes que tenga un adaptador de cliente MCP.
Los clientes más antiguos pueden aplicar un límite de herramientas por servidor; actualiza a una versión reciente para acceder al catálogo completo.
Los límites de velocidad y los cargos por uso siguen el plan de tu cuenta Wavix. Consulta Precios de Wavix.

Registro de cambios

El servidor alojado se actualiza continuamente a medida que evoluciona la especificación OpenAPI de Wavix; las nuevas herramientas aparecen automáticamente y los argumentos de las herramientas existentes pueden ganar campos opcionales. Los cambios de documentación de este repositorio se rastrean en Releases. Para cambios de comportamiento sustanciales que afecten las entradas de herramientas o la autenticación, publicaremos un aviso tanto allí como en las notas de versión de Wavix.

Soporte

Documentación del producto: https://docs.wavix.com
Referencia de API: https://docs.wavix.com/api-reference
Preguntas / comentarios: support@wavix.com

Contribuciones

Este repositorio es de código fuente disponible pero no está abierto a contribuciones externas. Las solicitudes de extracción (pull requests) se cierran automáticamente y los Issues / Discussions están deshabilitados. Envía informes de errores, solicitudes de funciones y comentarios a support@wavix.com. Consulta CONTRIBUTING.md para más detalles.

Si encuentras un error en el framework FastMCP subyacente, repórtalo allí en el proyecto upstream.

Seguridad

Para informar una vulnerabilidad de seguridad, envía un correo electrónico a support@wavix.com con el asunto Security: <short summary> en lugar de abrir un issue público. Consulta SECURITY.md para más detalles.