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

¿Qué puedes hacer con Wavix MCP?

Enviar mensajes SMS o MMS — pídele al asistente que envíe un mensaje de texto o multimedia usando sms_and_mms_messages_send.
Ejecutar un flujo de verificación 2FA — haz que el asistente cree una verificación con two_fa_verification_create y verifica el código que recibes mediante two_fa_verification_check.
Buscar y comprar números de teléfono — encuentra números disponibles por país y capacidad con buy_numbers_list, agrégalos a tu carrito y completa la compra.
Analizar transcripciones de llamadas — busca en los registros de llamadas frases específicas usando cdrs_search y recupera los metadatos completos con cdrs_get.
Descargar grabaciones y transcripciones — obtén una URL de grabación de llamada mediante call_recording_get, solicita la transcripción con cdrs_retranscribe y recupera el resultado.
Auditar facturación y descargar facturas — revisa las transacciones con billing_transactions_list y obtén un enlace de descarga PDF prefirmado mediante billing_invoices_download.

Documentación

Servidor MCP de Wavix

Un servidor del Protocolo de Contexto de Modelo que brinda a los LLMs y agentes de IA acceso directo a la plataforma de telecomunicaciones Wavix — SMS/MMS, llamadas de voz, 2FA, enlaces SIP, gestión de números telefónicos, registro 10DLC, grabaciones de llamadas, analítica de voz y facturación.

Wavix es una plataforma global de comunicaciones para enviar SMS, realizar llamadas de voz y ejecutar flujos de 2FA a través de una sola 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 autoalojarlo (despliegue personalizado de Wavix, detrás de un firewall, instancia dedicada), consulta Ejecuta el tuyo propio.

Tabla de contenidos

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

Endpoint

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

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

Instalar

Antes de empezar: obtén 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 en un clic

⚠️ Los botones de abajo siembran la configuración MCP de tu editor con un token de marcador de posición YOUR_API_KEY. Después de que el editor termine de instalar, abre la configuración generada y reemplaza el marcador de posición 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 elimina el conector a través de la interfaz de usuario 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 el estado.

Claude Desktop / Claude Web

Configuración → Conectores → Agregar conector personalizado:

Nombre: Wavix
URL: https://mcp.wavix.com/mcp
Transporte: Streamable HTTP
Cabecera 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 tienen un límite de 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 el usuario settings.json):

{
  "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 el esquema actualizado.

Codex CLI

Codex CLI soporta MCP sobre stdio. Conéctate al servidor alojado a través de 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 soporte transporte HTTP transmitible con cabeceras personalizadas funcionará. Usa:

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

¿Configurando a través de un agente de IA? Dirige a tu agente a llms-install.md — es una guía de instalación legible por máquina que proporciona al modelo la URL, cabecera y configuración por cliente en un formato determinista para que no improvise los valores del endpoint.

Ejecuta el tuyo propio

El servidor alojado funciona de inmediato para la mayoría de los usuarios. Autoalójalo si necesitas apuntar a un despliegue de Wavix no público, 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	Valor por defecto	Propósito
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Anula el endpoint de la API de Wavix ascendente (para despliegues internos o staging)

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

Ejemplos

Indicaciones concretas que puedes soltar 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) — seguros para copiar textualmente, no se puede contactar a suscriptores reales a través de ellos.

Enviar un SMS transaccional

Indicación: "Envía un SMS de +13105550100 a +447700900123 diciendo '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 recibo, verifica si es correcto."

El agente llama a two_fa_verification_create, espera a que compartas el código que llega por SMS, 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 de finalizar la compra — esto carga la cuenta.

Buscar transcripciones de llamadas

Indicación: "Muéstrame todas las llamadas entrantes de ayer de más de dos minutos donde la persona que llamó mencionó 'reembolso'."

El agente usa cdrs_search contra las transcripciones, luego enriquece cada resultado a través de cdrs_get para obtener los metadatos completos de la llamada.

Obtener 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 prefirmada), cdrs_retranscribe, luego consulta cdrs_transcription_get.

Auditar facturación

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

El agente llama a billing_transactions_list filtrado por tipo y fecha, luego billing_invoices_list + billing_invoices_download. La herramienta de descarga devuelve una URL prefirmada 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 voluntarias
Control de llamadas	9	Iniciar / responder / finalizar llamadas; reproducir audio; recolectar DTMF
Grabación de llamadas	3	Listar, descargar (URL prefirmada), eliminar
Transmisión de llamadas	2	Iniciar / detener flujo multimedia
Webhooks de llamadas	3	Listar, crear, eliminar
CDRs	6	Listar, exportar, recuperar; búsqueda de transcripción y retranscribir
Analítica de voz	4	Subir, transcribir, recuperar archivo original
2FA	6	Crear / verificar / cancelar / reenviar verificación; eventos
Mis números	7	Listar, actualizar, liberar; enrutamiento SMS / voz; subida 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 única y masiva
Enlaces 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	5	Listar, crear, activar / desactivar, eliminar
Subcuentas	5	Listar, crear, obtener, actualizar; transacciones
Facturación	3	Transacciones, facturas, descarga de estado de cuenta
Campañas de voz	2	Activar y recuperar
Wavix Embeddable (WebRTC)	5	CRUD de tokens de widget
Acortador de enlaces	2	Crear enlaces cortos; métricas

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

Recursos

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

Esquema URI	Contenidos
`wavix://docs/<path>`	Páginas de documentación de docs.wavix.com (autodescubiertas a través de `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 se pueden navegar directamente sin autenticación.

Los recursos se obtienen de forma diferida en resources/read y se almacenan en caché del lado del 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 esta cabecera a api.wavix.com por solicitud. El token:

nunca se registra,
nunca se reenvía en redireccionamientos entre hosts (por ejemplo, URLs de descarga S3 prefirmadas),
nunca se envía a los hosts de documentación.

Si tu cliente sigue una URL de descarga prefirmada devuelta por call_recording_get, billing_invoices_download, speech_analytics_file_get o ten_dlc_brand_evidence_get, recupérala directamente sin la cabecera Authorization.

Buenas prácticas

Usa una clave API dedicada para MCP. Crea una clave API separada en https://wavix.com → Administración → Claves API (o a través de 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: rota según un calendario y ante cualquier sospecha de filtración.
Mantén las claves API fuera de git. Las configuraciones del cliente MCP son fáciles de confirmar por accidente, llevándose el token al historial y a los registros de CI. La mayoría de los clientes soportan la sustitución de ${env:VAR} en el valor de la cabecera — almacena la clave API en una variable de entorno o en el llavero de tu sistema operativo y haz referencia a ella desde la configuración. Como red de seguridad, agrega las rutas comunes de configuración del cliente al .gitignore de tu proyecto:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Si un token está comprometido

En la Consola de Wavix, desactive la clave de inmediato (o llame a api_keys_deactivate).
Cree un reemplazo mediante api_keys_create o la Consola.
Actualice la configuración del cliente y reconéctese.
Revise billing_transactions_list y cdrs_list en busca de actividad inesperada.

Solución de problemas

Síntoma	Causa probable / solución
`401 Unauthorized` desde cualquier herramienta	Encabezado `Authorization: Bearer …` faltante o inválido. Verifique que la clave API esté activa en la Consola de Wavix.
La herramienta devuelve un `download_url`, no el archivo en sí	Comportamiento esperado. Los endpoints de grabación, factura, análisis de voz y evidencia 10DLC devuelven URLs prefirmadas (consulte Autenticación). Obtenga la URL directamente sin el encabezado `Authorization`.
El cliente solo muestra ~40 herramientas, no el catálogo completo	Los clientes más antiguos imponen un límite de herramientas por servidor. Actualice (Cursor 2.4+, último VS Code, último Claude).
`Tool not found` para una herramienta listada en este README	El cliente local puede estar almacenando en caché una lista de herramientas antigua. Reinicie el cliente, o elimine y vuelva a agregar el servidor.
4xx con un array `errors`	Error de validación de la API de Wavix. Inspeccione `errors`; consulte la página `wavix://docs/*` correspondiente o la especificación OpenAPI.
No se puede alcanzar el servidor	Confirme DNS y HTTPS saliente 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 — habilite esa configuración y rote a una clave API MCP dedicada (consulte Mejores prácticas).

Compatibilidad y límites

Compatible con cualquier cliente MCP que admita transporte HTTP transmitido en flujo (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDKs MCP personalizados) y cualquier marco de agente con un adaptador de cliente MCP.
Los clientes más antiguos pueden imponer un límite de herramientas por servidor; actualice 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 su cuenta Wavix. Consulte 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 en la documentación de este repositorio se rastrean en Lanzamientos. Para cambios sustanciales de comportamiento que afecten las entradas de herramientas o la autenticación, publicaremos un aviso tanto allí como en las notas de lanzamiento de Wavix.

Soporte

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

Contribuciones

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

Si encuentra un error en el marco subyacente FastMCP, infórmelo directamente allí.

Seguridad

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