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 SMS transaccional — Solicita el envío de un SMS con texto personalizado y número de remitente mediante sms_and_mms_messages_send.
Ejecutar verificación 2FA — Crea y verifica códigos de verificación para flujos de inicio de sesión sin contraseña usando two_fa_verification_create y two_fa_verification_check.
Buscar y comprar números — Busca números disponibles por país/características, agrégalos al carrito y finaliza la compra con confirmación mediante buy_numbers_list, cart_add y cart_checkout.
Buscar transcripciones de llamadas — Encuentra llamadas por duración y palabras clave en las transcripciones, y luego enriquece con metadatos completos mediante cdrs_search y cdrs_get.
Transcribir grabaciones de llamadas — Recupera una grabación de llamada, solicita la transcripción y consulta los resultados usando call_recording_get_by_call, cdrs_retranscribe y cdrs_transcription_get.
Auditar facturación — Lista transacciones y facturas filtradas por tipo y fecha mediante billing_transactions_list y billing_invoices_list.

Documentación

Servidor MCP de Wavix

Un Protocolo de Contexto de Modelo servidor 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 de 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 conéctate iniciando sesión con tu cuenta de Wavix o con una clave API de Wavix. Si necesitas autoalojar (implementación personalizada de Wavix, detrás de un firewall, instancia dedicada), consulta Ejecuta el tuyo.

Tabla de contenidos

Endpoint
Instalación — inicia sesión con una cuenta, clave API, instalación en un clic, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Ejecuta el tuyo (autoalojamiento)
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	HTTP transmisible
Autenticación	Inicia sesión con una cuenta de Wavix (OAuth 2.1), o `Authorization: Bearer <api_key>`
Herramientas	consulta TOOLS.md
Recursos	Documentación de Wavix + especificación OpenAPI (descubierta automáticamente)

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

Instalación

Dos formas de conectarse — elige la que admita tu cliente; ninguna es preferible sobre la otra.

Inicia sesión con una cuenta de Wavix

Si tu cliente MCP admite OAuth (Claude Desktop / Web y otros clientes compatibles con OAuth), conéctate sin clave API: agrega el conector para https://mcp.wavix.com/mcp y, cuando el cliente lo solicite, inicia sesión con tu cuenta de Wavix y aprueba el acceso. El cliente ejecuta el flujo OAuth 2.1 y almacena el token por sí mismo — no hay nada que pegar. Las herramientas que obtienes están limitadas a lo que apruebas y lo que permite el rol de tu cuenta (consulta Solución de problemas).

Conéctate con una clave API

Antes de comenzar: 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 a continuación 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 quita el conector a través de la interfaz 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>

Para conectarte iniciando sesión en su lugar, agrega el conector sin un encabezado de autenticación e inicia sesión con tu cuenta de Wavix cuando el cliente lo solicite.

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

Codex CLI

Codex CLI admite MCP sobre stdio. Conecta 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 admita transporte HTTP transmisible con encabezados personalizados funcionará. Usa:

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

¿Configurando a través de un agente de IA? Apunta tu agente a llms-install.md — es una guía de instalación legible por máquina que le da 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 de inmediato para la mayoría de los usuarios. Autoaloja si necesitas apuntar a una implementación de Wavix no pública, ejecutar 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 la API de Wavix ascendente (para implementaciones internas o de prueba)
`OAUTH_ISSUER`	sin establecer	URL base del servidor de autorización OAuth 2.1. Su JWKS se lee desde `<issuer>/.well-known/jwks.json`
`OAUTH_RESOURCE`	sin establecer	URL base pública a la que se accede a este servidor, utilizada como identificador de recurso
`OAUTH_API_KEY_PASSTHROUGH`	`true`	Con OAuth activado, acepta también un bearer que no sea un JWT de OAuth y reenvíalo ascendente (las claves API siguen funcionando). Establece `false` para requerir un JWT
`MCP_PATH`	`/mcp`	Ruta en la que se sirve el endpoint MCP

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. Los autoalojadores son responsables de terminar TLS frente al servidor (nginx, Caddy, balanceador de carga en la nube) antes de exponerlo públicamente.

OAuth 2.1 (opcional)

Establece OAUTH_ISSUER y OAUTH_RESOURCE juntos para convertir el servidor en un recurso protegido por OAuth 2.1. Luego publica metadatos RFC 9728 en /.well-known/oauth-protected-resource<MCP_PATH>, valida los tokens de acceso entrantes como JWT contra el JWKS del emisor y responde a solicitudes no autenticadas con un desafío WWW-Authenticate que apunta a esos metadatos. Los clientes MCP que admiten OAuth usan esto para ejecutar el flujo de autorización por sí mismos, por lo que los usuarios ya no pegan una clave API en su configuración de cliente.

La audiencia que cada token debe llevar es OAUTH_RESOURCE + MCP_PATH, que también es el valor resource publicado en los metadatos. Los servidores de autorización que implementan RFC 8707 comparan el parámetro resource del cliente contra esa cadena exactamente, por lo que ambos deben configurarse para que coincidan, incluida la ruta.

Habilitar OAuth no corta a los clientes que se autentican con una clave API de Wavix. Un token bearer que no sea un JWT de OAuth válido se reenvía ascendente sin verificar, exactamente como antes, dejando a la API de Wavix como única autoridad sobre él — por lo que una implementación existente puede activar OAuth para nuevos clientes sin romper los ya conectados. Una solicitud sin token alguno aún recibe el desafío WWW-Authenticate, que es lo que permite a un cliente compatible con OAuth descubrir el servidor de autorización. Solo las conexiones autenticadas con OAuth se filtran por alcance; una conexión con clave API ve toda la superficie de herramientas.

Establece OAUTH_API_KEY_PASSTHROUGH=false para eliminar ese respaldo y requerir un JWT válido — el modo estricto al que cambiar una vez que se retire el acceso con clave API.

Dejar sin establecer cualquiera de OAUTH_ISSUER / OAUTH_RESOURCE mantiene el comportamiento anterior: no se publican metadatos y cualquier token bearer que envíe el cliente se reenvía ascendente sin verificar.

Ejemplos

Indicaciones concretas que puedes insertar 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, ningún suscriptor real es alcanzable a través de ellos.

Enviar un SMS transaccional

Indicación: "Envía un SMS desde +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 reciba, 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 característica), cart_add y cart_checkout. cart_checkout primero devuelve una vista previa con los números y sus tarifas, y cobra a la cuenta solo cuando se llama nuevamente con su confirmation_token.

Buscar transcripciones de llamadas

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

El agente usa cdrs_search contra las transcripciones, luego enriquece cada resultado a través de cdrs_get para obtener 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_by_call (devuelve una URL de descarga pre-firmada), cdrs_retranscribe, luego consulta cdrs_transcription_get.

Auditar facturación

Indicación: "¿Cuánto gastamos en SMS el mes pasado y qué facturas se emitieron?"

El agente llama a billing_transactions_list filtrado por tipo y fecha, luego billing_invoices_list. La descarga del PDF de la factura no está expuesta a través de MCP — obténlo desde la API de Wavix o el panel de control.

Herramientas

Generado a partir de la especificación OpenAPI de Wavix. Los argumentos reflejan los parámetros de solicitud y los campos del cuerpo. Las herramientas mostradas dependen de los permisos que apruebes al iniciar sesión y las características habilitadas en tu cuenta.

Grupo	Cobertura
SMS y MMS	Enviar, listar, recuperar mensajes; remitentes; exclusiones
WhatsApp	Cuentas de negocio; remitentes; plantillas; enviar / listar / recuperar mensajes
Control de llamadas	Iniciar / responder / finalizar llamadas; reproducir audio; recopilar DTMF
Grabación de llamadas	Listar, descargar (URL pre-firmada), eliminar
Transmisión de llamadas	Iniciar / detener transmisión de medios
Webhooks de llamadas	Listar, crear, eliminar
CDRs	Listar, recuperar; búsqueda de transcripciones y retranscripción
Análisis de voz	Transcribir, recuperar archivo original
2FA	Crear / verificar / cancelar / reenviar verificación; eventos
Mis números	Listar, actualizar, liberar; enrutamiento SMS / voz
Comprar	Países, regiones, ciudades; búsqueda de números disponibles
Carrito	Agregar, eliminar, recuperar, finalizar compra
Validador de números	Validación individual y masiva
Troncales SIP	CRUD completo
10DLC	Marcas, campañas, verificación, evidencia, suscripciones a eventos
Perfil	Obtener / actualizar perfil; configuración de cuenta
Claves API	Listar, crear, actualizar, eliminar
Subcuentas	Listar, crear, obtener, actualizar; transacciones
Facturación	Transacciones; listar facturas / estados de cuenta
Campañas de voz	Activar y recuperar
Wavix Incrustable (WebRTC)	CRUD de tokens de widget
Acortador de enlaces	Crear enlaces cortos; métricas

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

Recursos

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

Esquema de URI	Contenido
`wavix://docs/<path>`	Páginas de documentación de docs.wavix.com (auto-descubiertas a través de `llms.txt`).
`wavix://api/openapi.yaml`	La especificación completa de 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

El servidor alojado acepta dos métodos de conexión — ninguno es preferente:

Iniciar sesión con una cuenta de Wavix (OAuth 2.1). Para clientes compatibles con OAuth. El cliente ejecuta el flujo de autorización y el usuario inicia sesión; no se almacena ninguna clave API. El acceso está limitado por alcance a lo que el usuario aprueba y lo que permite su rol de cuenta. Consulta Iniciar sesión con una cuenta de Wavix.
Clave API de Wavix (Bearer). Para cualquier cliente HTTP Streamable. Cada solicitud debe incluir:

Authorization: Bearer <api_key>

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

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

Si tu cliente sigue una URL de descarga pre-firmada devuelta por call_recording_get_by_call, 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 de MCP sin interrumpir otras integraciones.
Rota periódicamente. Trata la clave API como cualquier secreto de producción: rota según un cronograma 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 consigo al historial y a los registros de CI. La mayoría de los clientes admiten la sustitución de ${env:VAR} en el valor del encabezado — almacena 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 una credencial se ve comprometida

Si te conectaste con una clave API:

En la Consola de Wavix, desactiva o elimina esa clave inmediatamente (o llama a api_keys_delete).
Crea un reemplazo a través de api_keys_create o la Consola.
Actualiza la configuración del cliente y vuelve a conectarte.

Si te conectaste iniciando sesión con tu cuenta de Wavix:

Revoca la conexión desde la página de gestión de concesiones del portal de Wavix, que lista las conexiones que autorizaste y revoca la que elijas — esto invalida los tokens de esa conexión. No se involucra ninguna clave API.
Vuelve a conectarte e inicia sesión nuevamente.

En cualquier caso, 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	Falló la autenticación. Con una clave API: el encabezado `Authorization: Bearer …` falta, o la clave es inválida o está inactiva — verifícala en la Consola de Wavix. Con inicio de sesión de cuenta: tu sesión/token expiró o fue revocado, o el inicio de sesión nunca se completó — vuelve a conectarte e inicia sesión nuevamente.
La herramienta devuelve un `download_url`, no el archivo en sí	Esperado. Los endpoints de grabación, análisis de voz y evidencia 10DLC devuelven URL pre-firmadas (consulta Autenticación). Obtén la URL directamente sin el encabezado `Authorization`.
El cliente muestra solo parte del catálogo	Los clientes más antiguos imponen un límite de herramientas por servidor. Actualiza (Cursor 2.4+, VS Code más reciente, Claude más reciente).
Menos herramientas disponibles después de iniciar sesión con una cuenta de Wavix	Esperado. El inicio de sesión de cuenta está filtrado por alcance — obtienes las herramientas que permiten tus alcances aprobados y tu rol de cuenta, no el catálogo completo. Una conexión con clave API ve la superficie completa de herramientas. Para ampliar el conjunto, aprueba más alcances al iniciar sesión (sujeto a tu rol) o conéctate con una clave API que los incluya.
`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 agregar 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 alcanzar el servidor	Confirma DNS y HTTPS saliente a `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 — habilita esa configuración y rota a una clave API MCP dedicada (consulta Mejores prácticas).

Compatibilidad y límites

Compatible con cualquier cliente MCP que admita transporte HTTP Streamable (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDKs MCP personalizados) y cualquier framework de agentes con un adaptador de cliente MCP.
Cada herramienta anotada con destructiveHint, además de call_webhooks_create, sip_trunks_update y sub_accounts_update, se ejecuta en dos pasos: la primera llamada devuelve una vista previa y un confirmation_token de un solo uso (válido por 5 minutos), y la acción se ejecuta solo cuando la herramienta se llama nuevamente con los mismos argumentos y ese token. Cualquier cliente MCP puede hacer esto; no se necesita soporte de confirmación del lado del cliente.
Los clientes más antiguos pueden imponer 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 de 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 para 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 se cierran automáticamente, y los Problemas / Discusiones 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 subyacente FastMCP, repórtalo allí.

Seguridad

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