vapi

Original source / Raw SKILL.md

---
name: vapi
description: Build AI voice assistants and phone agents with Vapi. Use this skill when users want to create voice agents, phone bots, IVR systems, outbound calling campaigns, or any voice-based AI application.
---

# Vapi - AI Voice Assistant Builder

Build AI-powered voice assistants, phone agents, and conversational AI applications with Vapi.

## When This Skill is Activated

When a user wants to build a voice assistant or phone agent, follow these steps:

### Step 1: Check if Vapi MCP is Installed

First, check if the Vapi MCP server is available by looking for `vapi_` tools. If not available, tell the user to run:

```bash
claude mcp add vapi -- npx -y @vapi-ai/mcp-server
```

Then restart Claude Code and continue with Step 2.

### Step 2: Authenticate with Vapi

If the user hasn't authenticated yet (tools return auth errors):

1. Call `vapi_login` to start the OAuth flow
2. Tell the user to open the provided URL and sign in
3. Once authenticated, proceed with their request

### Step 3: Build the Voice Assistant

Before creating an assistant, fetch the latest prompt engineering guidelines from the [Prompt Guide](https://raw.githubusercontent.com/VapiAI/mcp-server/main/skill/PROMPT_GUIDE.md).

Use these guidelines to craft effective voice assistant prompts based on what the user wants to build.

## Available Tools

### Authentication
- `vapi_login` - Start OAuth authentication flow
- `vapi_logout` - Log out and clear stored credentials

### Assistants
- `vapi_list_assistants` - List all assistants
- `vapi_get_assistant` - Get assistant details
- `vapi_create_assistant` - Create new assistant
- `vapi_update_assistant` - Update assistant
- `vapi_delete_assistant` - Delete assistant

### Calls
- `vapi_list_calls` - List call history
- `vapi_get_call` - Get call details
- `vapi_create_call` - Start outbound call

### Phone Numbers
- `vapi_list_phone_numbers` - List phone numbers
- `vapi_buy_phone_number` - Purchase new number
- `vapi_update_phone_number` - Update number settings
- `vapi_delete_phone_number` - Release number

### Tools (Function Calling)
- `vapi_list_tools` - List custom tools
- `vapi_create_tool` - Create tool for API integration
- `vapi_update_tool` - Update tool
- `vapi_delete_tool` - Delete tool

## Workflow Examples

**User:** "I want to build a voice assistant that can schedule appointments"

**Claude should:**
1. Check for Vapi MCP -> install if needed
2. Authenticate if needed
3. Fetch the prompt guide for best practices
4. Ask about their business to understand context
5. Create an assistant with a scheduling-focused prompt
6. Offer to set up a phone number
7. Help create calendar integration tools if needed

**User:** "Make me a phone bot that answers questions about my business"

**Claude should:**
1. Ensure Vapi MCP is installed and authenticated
2. Fetch the prompt guide for best practices
3. Ask about the business: name, services, hours, common questions
4. Craft a system prompt following the guidelines
5. Create the assistant
6. Help provision or connect a phone number
7. Offer to test with a sample call