volai

API de telefonía checa y MCP para aplicaciones y agentes de IA: números, llamadas, SMS, agente de voz (servidor remoto en https://volai.cz/mcp).

GitHub

Documentación

volai

API telefónico checo y MCP para aplicaciones y agentes de IA: números, llamadas, SMS, agente de voz. Este plugin conecta Codex y Claude Code al servidor MCP de volai (75 herramientas: números, llamadas, SMS, agentes de voz, webhooks, calendarios conectados y facturas) e incluye la habilidad completa volai para que Claude conozca las convenciones de la API (números E.164, precios en hellers checos, claves de idempotencia) sin necesidad de indicaciones adicionales.

Instalación

claude plugin marketplace add https://volai.cz/.claude-plugin/marketplace.json
claude plugin install volai@volai

Iniciar sesión con volai

El plugin utiliza OAuth. Conecta el servidor, abre la página de inicio de sesión y aprueba el acceso a tu cuenta de volai. La página de consentimiento describe el acceso a los datos de la cuenta, agentes de voz, llamadas de pago, SMS y pedidos de números. Puedes revocar el acceso en cualquier momento en API y MCP en el portal de volai.

Para una conexión MCP directa en Claude Code:

claude mcp add --transport http volai https://volai.cz/mcp

Luego usa /mcp para autenticarte. En Codex, añade la URL MCP remota https://volai.cz/mcp e inicia sesión. Este archivo incluye tanto los manifiestos de plugin de Claude como de Codex. La distribución a través del marketplace propio de este proyecto no implica la aprobación de ningún directorio oficial.

Alternativa con clave API

Las claves API existentes siguen siendo compatibles. Para una conexión manual en Claude Code:

claude mcp add --transport http --header 'Authorization: Bearer vk_YOUR_KEY' volai https://volai.cz/mcp

Los ejemplos REST en examples/ leen VOLAI_API_KEY:

export VOLAI_API_KEY=vk_YOUR_KEY

Obtén una clave en el portal de volai en API y MCP (https://volai.cz/en/api-and-mcp) después de registrarte en https://volai.cz/en/auth/signup. Trata la clave como una contraseña: cualquiera que la tenga puede gastar tu crédito (comprar números, hacer llamadas, enviar SMS).

Lo que obtienes

  • Servidor MCP (https://volai.cz/mcp): las mismas 75 herramientas documentadas en https://volai.cz/en/docs/mcp, autenticadas mediante OAuth o una clave API.
  • Habilidad volai (skills/volai/SKILL.md): la referencia completa de la API (autenticación, convenciones, endpoints, lista de herramientas) para que Claude elija la herramienta y los nombres de campo correctos sin adivinar.
  • Ejemplos (examples/): dos pequeños scripts de Node 20 (send-sms.mjs, make-call.mjs) que llaman a la API REST directamente con fetch, sin dependencias.

Pruébalo

Una vez instalado, solo pregunta a Claude Code cosas como:

  • "Envía un SMS al +420777123456 diciendo que el pedido está listo."
  • "Llámame al +420777123456 e intenta ser recepcionista de una cafetería: no quiero configurar mi propio número o agente para esto."
  • "Lista mis últimas 10 llamadas y resúmelas."

Más información

Documentación completa: https://volai.cz/en/docs. Precios: https://volai.cz/en/pricing. Soporte: podpora@volai.cz.

Licencia

MIT, ver LICENSE. (c) ANOVIA Finance s.r.o.