Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 6 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,14 @@ Build AI voice assistants and phone agents with [Vapi](https://vapi.ai) using th
<img width="380" height="200" src="https://glama.ai/mcp/servers/@VapiAI/mcp-server/badge" alt="Vapi Server MCP server" />
</a>

## Claude Code Setup (Recommended)
## Claude Code Setup

The easiest way to get started. No API key needed - authenticate via browser on first use.
The MCP server requires a Vapi API key. Get one from the [Vapi dashboard](https://dashboard.vapi.ai/org/api-keys).

### 1. Add MCP Server

```bash
claude mcp add vapi -- npx -y @vapi-ai/mcp-server
claude mcp add -e VAPI_TOKEN=your_vapi_token vapi -- npx -y @vapi-ai/mcp-server
```

### 2. Install Skill (Optional)
Expand All @@ -29,28 +29,15 @@ curl -o ~/.claude/skills/vapi/SKILL.md https://raw.githubusercontent.com/VapiAI/

### 3. Restart Claude Code

After restarting, use `/vapi` or ask Claude to help build a voice assistant. On first use, you'll be prompted to sign in via browser - no API key copy-paste needed.
After restarting, use `/vapi` or ask Claude to help build a voice assistant.

---

## Claude Desktop Setup

### With OAuth (No API Key)
### Local Configuration

```json
{
"mcpServers": {
"vapi": {
"command": "npx",
"args": ["-y", "@vapi-ai/mcp-server"]
}
}
}
```

### With API Key

If you prefer to use an API key directly, get one from the [Vapi dashboard](https://dashboard.vapi.ai/org/api-keys):
Get an API key from the [Vapi dashboard](https://dashboard.vapi.ai/org/api-keys):

```json
{
Expand Down Expand Up @@ -195,12 +182,6 @@ Connect to Vapi's hosted MCP server from any MCP client:
| `vapi_update_tool` | Update tool |
| `vapi_delete_tool` | Delete tool |

### Authentication
| Tool | Description |
|------|-------------|
| `vapi_login` | Start OAuth flow |
| `vapi_logout` | Log out and clear credentials |

---

## Development
Expand Down
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "@vapi-ai/mcp-server",
"description": "Vapi MCP Server - Build AI voice assistants with Claude",
"version": "0.0.10",
"version": "0.0.9",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"type": "module",
Expand Down Expand Up @@ -42,7 +42,7 @@
"dev:shttp-example": "tsx examples/shttp-client.ts",
"inspector": "mcp-inspector",
"test": "NODE_OPTIONS=--experimental-vm-modules jest",
"test:unit": "NODE_OPTIONS=--experimental-vm-modules jest src/tests/mcp-server-mock.test.ts",
"test:unit": "VAPI_TOKEN=test-mock-token NODE_OPTIONS=--experimental-vm-modules jest src/__tests__/mcp-server-mock.test.ts",
"test:e2e": "NODE_OPTIONS=--experimental-vm-modules jest src/tests/mcp-server-e2e.test.ts"
},
"files": [
Expand Down
18 changes: 5 additions & 13 deletions skill/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,18 +16,14 @@ When a user wants to build a voice assistant or phone agent, follow these steps:
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
claude mcp add -e VAPI_TOKEN=your_vapi_token vapi -- npx -y @vapi-ai/mcp-server
```

Then restart Claude Code and continue with Step 2.

### Step 2: Authenticate with Vapi
### Step 2: Confirm Vapi Credentials

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
If the tools return authentication errors, tell the user to configure `VAPI_TOKEN` with a Vapi API key in their MCP server environment and restart Claude Code.

### Step 3: Build the Voice Assistant

Expand All @@ -37,10 +33,6 @@ Use these guidelines to craft effective voice assistant prompts based on what th

## 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
Expand Down Expand Up @@ -71,7 +63,7 @@ Use these guidelines to craft effective voice assistant prompts based on what th

**Claude should:**
1. Check for Vapi MCP -> install if needed
2. Authenticate if needed
2. Confirm `VAPI_TOKEN` is configured if the tools return authentication errors
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
Expand All @@ -81,7 +73,7 @@ Use these guidelines to craft effective voice assistant prompts based on what th
**User:** "Make me a phone bot that answers questions about my business"

**Claude should:**
1. Ensure Vapi MCP is installed and authenticated
1. Ensure Vapi MCP is installed and configured with `VAPI_TOKEN`
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
Expand Down
257 changes: 0 additions & 257 deletions src/auth.ts

This file was deleted.

Loading