A set of skills and MCP connector to allow agents to build Vapi AI agents, from creating tools and assistants to a phone call
$git clone https://github.com/vapiai/skillsInstalls into the current project.
Install skills by running `git clone https://github.com/vapiai/skills`, then use it for the current task and follow its documentation at https://github.com/vapiai/skills.
| 1 | # Vapi Skills |
| 2 | |
| 3 | Agent skills for [Vapi](https://vapi.ai) — the developer platform for building voice AI agents. These skills follow the [Agent Skills specification](https://agentskills.io/specification) and can be used with any compatible AI coding assistant including Claude Code, Cursor, VS Code Copilot, Gemini CLI, and more. |
| 4 | |
| 5 | ## Installation |
| 6 | |
| 7 | ### Option 1: npx skills (works with all agents) |
| 8 | |
| 9 | ```bash |
| 10 | npx skills add VapiAI/skills |
| 11 | ``` |
| 12 | |
| 13 | Install specific skills: |
| 14 | |
| 15 | ```bash |
| 16 | npx skills add VapiAI/skills --skill create-assistant |
| 17 | npx skills add VapiAI/skills --skill create-tool |
| 18 | ``` |
| 19 | |
| 20 | Install for a specific agent: |
| 21 | |
| 22 | ```bash |
| 23 | npx skills add VapiAI/skills -a claude-code |
| 24 | npx skills add VapiAI/skills -a cursor |
| 25 | ``` |
| 26 | |
| 27 | ### Option 2: Claude Code Plugin (native integration) |
| 28 | |
| 29 | ``` |
| 30 | /plugin marketplace add VapiAI/skills |
| 31 | /plugin install vapi-voice-ai@vapi-skills |
| 32 | ``` |
| 33 | |
| 34 | ### Option 3: Manual installation |
| 35 | |
| 36 | Copy any skill directory into your project's `.claude/skills/` (for Claude Code), `.cursor/skills/` (for Cursor), or the equivalent skills directory for your agent. |
| 37 | |
| 38 | ## Vapi Documentation Server (MCP) |
| 39 | |
| 40 | This repository includes configuration for the [Vapi documentation MCP server](https://docs.vapi.ai), which gives your AI agent access to the full Vapi knowledge base via RAG. It activates automatically in agents that support MCP. |
| 41 | |
| 42 | The skills cover common workflows. The MCP docs server fills in the gaps — advanced configuration, troubleshooting, SDK details, and more. |
| 43 | |
| 44 | ### Supported agents |
| 45 | |
| 46 | | Agent | Config File | Auto-detected | |
| 47 | |-------|------------|---------------| |
| 48 | | Claude Code | `.mcp.json` | Yes | |
| 49 | | Cursor | `.cursor/mcp.json` | Yes | |
| 50 | | VS Code Copilot | `.vscode/mcp.json` | Yes | |
| 51 | |
| 52 | **Requires:** Node.js (for `npx`). Uses [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) to bridge the remote server. No API key needed for the docs server. |
| 53 | |
| 54 | ### Manual setup |
| 55 | |
| 56 | If your agent doesn't auto-detect MCP configs: |
| 57 | |
| 58 | **Claude Code:** |
| 59 | ```bash |
| 60 | claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server |
| 61 | ``` |
| 62 | |
| 63 | **Any agent (JSON config):** |
| 64 | ```json |
| 65 | { |
| 66 | "mcpServers": { |
| 67 | "vapi-docs": { |
| 68 | "command": "npx", |
| 69 | "args": ["-y", "mcp-remote", "https://docs.vapi.ai/_mcp/server"] |
| 70 | } |
| 71 | } |
| 72 | } |
| 73 | ``` |
| 74 | |
| 75 | ## Available Skills |
| 76 | |
| 77 | | Skill | Description | |
| 78 | |-------|-------------| |
| 79 | | [setup-api-key](./setup-api-key) | Guide through obtaining and configuring a Vapi API key | |
| 80 | | [create-assistant](./create-assistant) | Create voice AI assistants with models, voices, transcribers, tools, and hooks | |
| 81 | | [vapi-prompt-builder](./vapi-prompt-builder) | Create, improve, or audit production-ready Vapi voice agent and Squad system prompts | |
| 82 | | [create-tool](./create-tool) | Build custom tools for assistants — function calls, transfers, integrations | |
| 83 | | [create-call](./create-call) | Initiate outbound phone calls, web calls, and batch calls | |
| 84 | | [create-squad](./create-squad) | Build multi-assistant squads with handoff workflows | |
| 85 | | [create-phone-number](./create-phone-number) | Set up phone numbers from Twilio, Vonage, Telnyx, or Vapi | |
| 86 | | [setup-webhook](./setup-webhook) | Configure server URLs to receive real-time call events | |
| 87 | | [vapi-bootstrap-framework](./vapi-bootstrap-framework) | Scaffold a full Bun + TypeScript voice-agent project from a `ROUGH_DRAFT.md` — multi-scenario, multi-language assistants with an idempotent bootstrap script | |
| 88 | |
| 89 | ## Configuration |
| 90 | |
| 91 | All skills require a Vapi API key. Set it as an environment variable: |
| 92 | |
| 93 | ```bash |
| 94 | export VAPI_API_KEY="your-api-key" |
| 95 | ``` |
| 96 | |
| 97 | Get your API key from the [Vapi Dashboard](https://dashboard.vapi.ai/org/api-keys) or use the `setup-api-key` skill. |
| 98 | |
| 99 | ## SDK Support |
| 100 | |
| 101 | Skills include examples for: |
| 102 | |
| 103 | - **cURL** — Direct REST API calls |
| 104 | - **TypeScript** — `npm install @vapi-ai/server-sdk` |
| 105 | - **Python** — `pip install requests` (direct API) or Vapi's Python SDK |
| 106 | - **Web SDK** — `npm install @vapi-ai/web` (client-side, uses public API key) |
| 107 | |
| 108 | ## Quick Start |
| 109 | |
| 110 | 1. **Get an API key**: Use the `setup-api-key` skill or visit https://dashboard.vapi.ai/org/api-keys |
| 111 | 2. **Create an assistant**: Use the `create-assistant` skill to build a voice AI agent |
| 112 | 3. **Add a phone number**: Use `create-phone-number` to get a phone number |
| 113 | 4. **Make a call**: Use `create-call` to test your assistant |
| 114 | |
| 115 | ## API Reference |
| 116 | |
| 117 | - **Base URL**: `https://api.vapi.ai` |
| 118 | - **Authentication**: Bearer token via `Authorization: Bearer $VAPI_API_KEY` |
| 119 | - **Full API Docs**: https://docs.vapi.ai |
| 120 | - **MCP Docs Server**: `https://docs.vapi.ai/_mcp/server` (auto-configured via `.mcp.json`) |
| 121 | - **API Swagger**: https://api.vapi.ai/api |
| 122 | |
| 123 | ## License |
| 124 | |
| 125 | MIT |