volai

volai

API telefónico checo y MCP para aplicaciones y agentes de IA: números, llamadas, SMS y agente de voz.

volai es una alternativa checa a Twilio para desarrolladores y agentes de IA: números de teléfono +420, llamadas, SMS y un agente de voz a través de una API REST y un servidor MCP, facturado por segundo en CZK.

• Documentación: volai.cz/docs/mcp (MCP), volai.cz/en/docs (API REST)
• Obtén una clave de API: volai.cz/en/api-and-mcp (después de registrarte en volai.cz/en/auth/signup, no se requiere tarjeta de crédito para comenzar)
• Referencia completa para agentes de IA y asistentes de codificación: skills/volai/SKILL.md (instalable vía npx skills add volai.cz)

Qué hay en este repositorio

Ruta	Qué es
.mcp.json	Configuración del servidor MCP, colócala en cualquier cliente compatible con MCP
.claude-plugin/plugin.json	Manifiesto del plugin de Claude Code
gemini-extension.json	Manifiesto de extensión de Gemini CLI (mismo servidor MCP remoto)
skills/volai/SKILL.md	Referencia completa de API y MCP para agentes de IA
examples/make-call.mjs	Script mínimo de Node.js que realiza una llamada de prueba del agente de voz a través de la API REST
examples/send-sms.mjs	Script mínimo de Node.js que envía un SMS a través de la API REST

Instalar el servidor MCP

El servidor MCP de volai es remoto (HTTP transmisible): no hay nada que compilar o ejecutar localmente.

Claude Code (plugin con la habilidad incluida)

claude plugin marketplace add https://volai.cz/.claude-plugin/marketplace.json
claude plugin install volai@volai
export VOLAI_API_KEY=vk_YOUR_KEY

Claude Code (solo servidor MCP)

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

Gemini CLI

gemini extensions install https://github.com/radekklein92/volai-plugin
export VOLAI_API_KEY=vk_YOUR_KEY

Cursor, Windsurf y otros clientes MCP

Agrega esto a tu configuración de MCP (misma forma que .mcp.json en este repositorio):

{
  "mcpServers": {
    "volai": {
      "type": "http",
      "url": "https://volai.cz/mcp",
      "headers": {
        "Authorization": "Bearer vk_YOUR_KEY"
      }
    }
  }
}

Guías paso a paso por cliente (Cursor, Windsurf, Claude Desktop, n8n, Make, Lovable): volai.cz/en/integrations.

Obtén vk_YOUR_KEY en el portal de volai bajo API y MCP (volai.cz/en/api-and-mcp) después de registrarte en volai.cz/en/auth/signup. Trata la clave como una contraseña: cualquiera que la tenga puede gastar tu crédito.

31 herramientas cubren números de teléfono, llamadas salientes y entrantes, SMS, agentes de voz y webhooks. Lista completa de herramientas: skills/volai/SKILL.md.

API REST

Misma cuenta, misma clave de API, mismos datos que el servidor MCP: una buena opción para tu propio backend. Ejemplo (Node.js 20+, sin dependencias):

VOLAI_API_KEY=vk_... node examples/send-sms.mjs +420777123456 "Hello from volai"
VOLAI_API_KEY=vk_... node examples/make-call.mjs +420777123456 \
  "You are a friendly receptionist for a small cafe. Ask what the caller needs."

Referencia completa: volai.cz/en/docs.

Licencia

MIT: consulta LICENSE. Este repositorio es un paquete de plugin/configuración y un conjunto de ejemplos; volai en sí es un SaaS alojado (volai.cz), operado por ANOVIA Finance s.r.o.