volai

volai

API de telefonia tcheca e MCP para aplicativos e agentes de IA - números, chamadas, SMS e agente de voz.

volai é uma alternativa tcheca ao Twilio para desenvolvedores e agentes de IA: números de telefone +420, chamadas, SMS e um agente de voz através de uma API REST e um servidor MCP, cobrado por segundo em CZK.

• Documentação: volai.cz/docs/mcp (MCP), volai.cz/en/docs (API REST)
• Obtenha uma chave de API: volai.cz/en/api-and-mcp (após se cadastrar em volai.cz/en/auth/signup, não é necessário cartão de crédito para começar)
• Referência completa para agentes de IA e assistentes de codificação: skills/volai/SKILL.md (instalável via npx skills add volai.cz)

O que há neste repositório

Caminho	O que é
.mcp.json	Configuração do servidor MCP, insira em qualquer cliente compatível com MCP
.claude-plugin/plugin.json	Manifesto do plugin Claude Code
gemini-extension.json	Manifesto da extensão Gemini CLI (mesmo servidor MCP remoto)
skills/volai/SKILL.md	Referência completa da API e MCP para agentes de IA
examples/make-call.mjs	Script Node.js mínimo que realiza uma chamada de teste do agente de voz via API REST
examples/send-sms.mjs	Script Node.js mínimo que envia um SMS via API REST

Instale o servidor MCP

O servidor MCP do volai é remoto (HTTP com streaming) - não há nada para compilar ou executar localmente.

Claude Code (plugin com a skill integrada)

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 (apenas 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 e outros clientes MCP

Adicione isto à sua configuração MCP (mesmo formato de .mcp.json neste repositório):

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

Guias passo a passo por cliente (Cursor, Windsurf, Claude Desktop, n8n, Make, Lovable): volai.cz/en/integrations.

Obtenha vk_YOUR_KEY no portal volai em API e MCP (volai.cz/en/api-and-mcp) após se cadastrar em volai.cz/en/auth/signup. Trate a chave como uma senha - qualquer pessoa que a tiver pode gastar seu crédito.

31 ferramentas cobrem números de telefone, chamadas de saída e entrada, SMS, agentes de voz e webhooks. Lista completa de ferramentas: skills/volai/SKILL.md.

API REST

Mesma conta, mesma chave de API, mesmos dados do servidor MCP - uma boa opção para seu próprio backend. Exemplo (Node.js 20+, sem dependências):

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."

Referência completa: volai.cz/en/docs.

Licença

MIT - veja LICENSE. Este repositório é um pacote de plugin/configuração e um conjunto de exemplos; o volai em si é um SaaS hospedado (volai.cz), operado pela ANOVIA Finance s.r.o.