vapi-skills

Vapi Skills

Agent skills for Vapi — the developer platform for building voice AI agents. These skills follow the Agent Skills specification and can be used with any compatible AI coding assistant including Claude Code, Cursor, VS Code Copilot, Gemini CLI, and more.

Installation

Option 1: npx skills (works with all agents)

npx skills add VapiAI/skills

Install specific skills:

npx skills add VapiAI/skills --skill create-assistant
npx skills add VapiAI/skills --skill create-tool

Install for a specific agent:

npx skills add VapiAI/skills -a claude-code
npx skills add VapiAI/skills -a cursor

Option 2: Claude Code Plugin (native integration)

/plugin marketplace add VapiAI/skills
/plugin install vapi-voice-ai@vapi-skills

Option 3: Manual installation

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.

Vapi Documentation Server (MCP)

This repository includes configuration for the Vapi documentation MCP server, which gives your AI agent access to the full Vapi knowledge base via RAG. It activates automatically in agents that support MCP.

The skills cover common workflows. The MCP docs server fills in the gaps — advanced configuration, troubleshooting, SDK details, and more.

Supported agents

Agent	Config File	Auto-detected
Claude Code	.mcp.json	Yes
Cursor	.cursor/mcp.json	Yes
VS Code Copilot	.vscode/mcp.json	Yes

Requires: Node.js (for npx). Uses mcp-remote to bridge the remote server. No API key needed for the docs server.

Manual setup

If your agent doesn't auto-detect MCP configs:

Claude Code:

claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server

Any agent (JSON config):

{
  "mcpServers": {
    "vapi-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.vapi.ai/_mcp/server"]
    }
  }
}

Available Skills

Skill	Description
setup-api-key	Guide through obtaining and configuring a Vapi API key
create-assistant	Create voice AI assistants with models, voices, transcribers, tools, and hooks
create-tool	Build custom tools for assistants — function calls, transfers, integrations
create-call	Initiate outbound phone calls, web calls, and batch calls
create-squad	Build multi-assistant squads with handoff workflows
create-phone-number	Set up phone numbers from Twilio, Vonage, Telnyx, or Vapi
setup-webhook	Configure server URLs to receive real-time call events
create-workflow	Build visual conversation workflows with branching logic

Configuration

All skills require a Vapi API key. Set it as an environment variable:

export VAPI_API_KEY="your-api-key"

Get your API key from the Vapi Dashboard or use the setup-api-key skill.

SDK Support

Skills include examples for:

• cURL — Direct REST API calls
• TypeScript — npm install @vapi-ai/server-sdk
• Python — pip install requests (direct API) or Vapi's Python SDK
• Web SDK — npm install @vapi-ai/web (client-side, uses public API key)

Quick Start

1. Get an API key: Use the setup-api-key skill or visit https://dashboard.vapi.ai/org/api-keys
2. Create an assistant: Use the create-assistant skill to build a voice AI agent
3. Add a phone number: Use create-phone-number to get a phone number
4. Make a call: Use create-call to test your assistant

API Reference

• Base URL: https://api.vapi.ai
• Authentication: Bearer token via Authorization: Bearer $VAPI_API_KEY
• Full API Docs: https://docs.vapi.ai
• MCP Docs Server: https://docs.vapi.ai/_mcp/server (auto-configured via .mcp.json)
• API Swagger: https://api.vapi.ai/api

License

MIT