{
  "markdown": "# volai\n\nCzech telephony API and MCP for apps and AI agents - numbers, calls, SMS,\nvoice agent.\n\n[![MIT license](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n\nvolai is a Czech alternative to Twilio for developers and AI agents:\n+420 phone numbers, calls, SMS and a voice agent through one REST API and\none MCP server, billed per second in CZK.\n\n- Docs: [volai.cz/docs/mcp](https://volai.cz/docs/mcp) (MCP), [volai.cz/en/docs](https://volai.cz/en/docs) (REST API)\n- Get an API key: [volai.cz/en/api-and-mcp](https://volai.cz/en/api-and-mcp) (after signing up at [volai.cz/en/auth/signup](https://volai.cz/en/auth/signup), no credit card required to start)\n- Full reference for AI agents and coding assistants: [`skills/volai/SKILL.md`](./skills/volai/SKILL.md) (installable via `npx skills add volai.cz`)\n\n## What's in this repo\n\n| Path | What it is |\n| --- | --- |\n| `.mcp.json` | MCP server config, drop into any MCP-compatible client |\n| `.claude-plugin/plugin.json` | Claude Code plugin manifest |\n| `gemini-extension.json` | Gemini CLI extension manifest (same remote MCP server) |\n| `skills/volai/SKILL.md` | Full API and MCP reference for AI agents |\n| `examples/make-call.mjs` | Minimal Node.js script that places a trial voice-agent call over the REST API |\n| `examples/send-sms.mjs` | Minimal Node.js script that sends an SMS over the REST API |\n\n## Install the MCP server\n\nvolai's MCP server is remote (streamable HTTP) - there is nothing to\nbuild or run locally.\n\n### Claude Code (plugin with the bundled skill)\n\n```bash\nclaude plugin marketplace add https://volai.cz/.claude-plugin/marketplace.json\nclaude plugin install volai@volai\nexport VOLAI_API_KEY=vk_YOUR_KEY\n```\n\n### Claude Code (MCP server only)\n\n```bash\nclaude mcp add --transport http volai https://volai.cz/mcp \\\n  --header \"Authorization: Bearer vk_YOUR_KEY\"\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/radekklein92/volai-plugin\nexport VOLAI_API_KEY=vk_YOUR_KEY\n```\n\n### Cursor, Windsurf and other MCP clients\n\nAdd this to your MCP config (same shape as [`.mcp.json`](./.mcp.json) in\nthis repo):\n\n```json\n{\n  \"mcpServers\": {\n    \"volai\": {\n      \"type\": \"http\",\n      \"url\": \"https://volai.cz/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer vk_YOUR_KEY\"\n      }\n    }\n  }\n}\n```\n\nPer-client walkthroughs (Cursor, Windsurf, Claude Desktop, n8n, Make,\nLovable): [volai.cz/en/integrations](https://volai.cz/en/integrations).\n\nGet `vk_YOUR_KEY` in the volai portal under **API and MCP**\n([volai.cz/en/api-and-mcp](https://volai.cz/en/api-and-mcp)) after\nsigning up at [volai.cz/en/auth/signup](https://volai.cz/en/auth/signup).\nTreat the key like a password - anyone who has it can spend your credit.\n\n31 tools cover phone numbers, outbound and inbound calls, SMS, voice\nagents and webhooks. Full tool list: [`skills/volai/SKILL.md`](./skills/volai/SKILL.md).\n\n## REST API\n\nSame account, same API key, same data as the MCP server - a good fit for\nyour own backend. Example (Node.js 20+, no dependencies):\n\n```bash\nVOLAI_API_KEY=vk_... node examples/send-sms.mjs +420777123456 \"Hello from volai\"\nVOLAI_API_KEY=vk_... node examples/make-call.mjs +420777123456 \\\n  \"You are a friendly receptionist for a small cafe. Ask what the caller needs.\"\n```\n\nFull reference: [volai.cz/en/docs](https://volai.cz/en/docs).\n\n## License\n\nMIT - see [LICENSE](./LICENSE). This repository is a plugin/config\npackage and a set of examples; volai itself is a hosted SaaS\n([volai.cz](https://volai.cz)), operated by ANOVIA Finance s.r.o.\n",
  "bytes": 3543,
  "sha": "c9069cd9ae2b9497847a073955ac516e20fb420c4f485dde5c450091f074147f",
  "repo_slug": "radekklein92/volai-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_radekklein92_volai_plugin_9d502089/readme"
}