# Vapi MCP

> Vapi brings automated voice communication into your existing chat workspace. Use this MCP to make outbound human-like phone calls, run web-based voice demos, and retrieve full call transcripts and metrics—all controlled by your AI agent. It lets you treat your chatbot like a real telephony dispatch center.

## Overview
- **Category:** ai-frontier
- **Price:** Free
- **Tags:** voice-ai, telephony, conversational-ai, webrtc, call-automation, transcription

## Description

Your AI client can now handle more than just text; it can talk on the phone. With this MCP, your agent gains the ability to place outbound calls using various numbers and even set up web-based voice connections. You don't have to switch applications or copy call logs into a separate system anymore. Need to know what happened during a client demo? Your agent pulls the full transcript and performance metrics instantly. Want to adjust how your assistant behaves? You can update its core persona, change its underlying language model, or even build entirely new specialized assistants without leaving your chat window. Because Vinkius hosts this MCP, you connect once from any compatible client (Claude, Cursor, etc.) and get full access to advanced voice operations—all guided by natural conversation.

## Tools

### create_assistant
Builds a brand-new voice AI assistant persona using specified configuration details.

### create_phone_call
Starts an outbound phone call immediately, requiring the target number and customer information.

### create_web_call
Generates a dedicated web link for setting up a voice call, useful for internal testing or virtual demos.

### get_call_details
Retrieves the full details, transcripts, and performance metrics associated with a specific call ID.

### list_assistants
Lists all currently configured voice AI assistants available in your Vapi account.

### list_calls
Shows a list of both active and recently completed voice calls managed by the system.

### list_phone_numbers
Retrieves a comprehensive list of every phone number connected to your Vapi account.

### list_squads
Lists all defined multi-agent teams or conversational pathways for complex routing.

### list_agent_tools
Shows a list of every tool that your Vapi assistants are currently allowed to use.

### update_assistant
Modifies the settings, prompts, or models for an existing voice AI assistant persona.

## Prompt Examples

**Prompt:** 
```
List all our configured Voice assistants and their IDs.
```

**Response:** 
```
You currently have 3 conversational Voice AI assistants configured in Vapi: 'Lead Qualification Bot' (ID: ba1-342x), 'Support Intake Matrix' (ID: cd3-99ab), and 'Internal Switchboard' (ID: 9fz-77qp). Do you want to see the system prompts behind any of these?
```

**Prompt:** 
```
Get the details and full transcript for call ID 'vapi1234'.
```

**Response:** 
```
I've retrieved the call log for 'vapi1234'. This was an outbound call that lasted 2 minutes and 15 seconds. 

**Summary:** The AI Assistant contacted John Doe about his recent warranty claim. John indicated he has already shipped the defective unit. The AI processed this information gracefully and closed the ticket conceptually.

Here is a snippet of the transcript:
*User:* 'Yeah I sent it out through FedEx yesterday.'
*Assistant:* 'Perfect, thank you John! I have updated your claim status to incoming...'
```

**Prompt:** 
```
Update assistant 'Bot Support' to change its `model.model` parameter to `gpt-4o-mini`.
```

**Response:** 
```
Successfully updated the conversational model for 'Bot Support'. It has transitioned in Vapi engine logic and is now utilizing `gpt-4o-mini`. Its next active conversation will run purely on this adjusted backend structure.
```

## Capabilities

### Initiate Outbound Calls
Instruct your agent to call a specific phone number or generate a web link for a live voice interaction.

### Access Call History and Metrics
Retrieve detailed records, full transcripts, and performance metrics from any past communication session.

### Configure AI Personas
Create new voice assistants or modify existing ones by updating their core instructions, model type, and voice IDs on the fly.

### Audit Telephony Resources
List all connected phone numbers, available multi-agent teams (squads), and defined tools for advanced call routing.

## Use Cases

### Post-Call Summarization for Support Tickets
A support agent receives an alert about a complex call. Instead of logging into the separate telephony system and manually transcribing minutes, they ask their agent to run 'get_call_details' on the specific ID. The agent instantly provides a summarized transcript detailing all agreed-upon next steps.

### Simulating Sales Demos
A sales engineer needs to test a new demo script before calling a client. They use 'list_phone_numbers' to pick an internal line, then prompt the agent to run 'create_web_call'. This lets them practice the flow and record metrics without risking real prospect data.

### Scaling Voice AI Personalities
A development team needs to launch a new product support bot. Instead of writing boilerplate code, they use 'create_assistant' to define its model and voice parameters. Later, if the script needs tweaking, they just run 'update_assistant'.

### Troubleshooting Call Routing
An operations manager notices call failures across different departments. They use 'list_squads' to view all possible routing paths and then check which tools are attached using 'list_agent_tools' to find the bottleneck.

## Benefits

- You instantly get full call transcripts by using 'get_call_details', eliminating the need to manually listen back to hours of recordings or copy/paste text.
- Manage your entire voice AI setup—including creating new personas with 'create_assistant' and tweaking existing ones with 'update_assistant'—all from a single prompt in your editor.
- Streamline demos by using 'list_phone_numbers' to audit available lines, then initiating a live test call via 'create_phone_call', all without leaving your workspace.
- Quickly summarize complex interactions; after a customer calls, you can use the agent to pull the transcript and generate summary action items based on what happened.
- Audit entire conversation pathways by listing multi-agent groups with 'list_squads' or checking which tools are available via 'list_agent_tools'.
- Get immediate visibility into your operations using 'list_calls' to see a log of recent activity, helping you audit usage patterns quickly.

## How It Works

The bottom line is, your chat agent becomes the control center for all your automated phone and voice work.

1. Subscribe to this MCP and enter your Vapi Private API Key into your AI client.
2. Use natural language prompts in your chat agent to initiate actions, such as asking the assistant to place a demo call or list current assistants.
3. Your AI client executes the voice operation through Vapi, providing you with real-time transcripts, detailed logs, and actionable data.

## Frequently Asked Questions

**How do I check if Vapi supports my company phone numbers?**
You use the 'list_phone_numbers' tool to pull a list of every number connected to your account for review. This ensures you know what resources are available before making a call.

**Can I change my assistant's voice or model using Vapi MCP?**
Yes, you use the 'update_assistant' tool. You can adjust settings like the underlying LLM model or mutate the Voice IDs on the fly without needing to access the main dashboard.

**What is the difference between list_assistants and list_calls?**
The 'list_assistants' tool shows you your conversational personas (the bots themselves). The 'list_calls' tool shows you logs of actual completed or active conversations.

**How do I start a demo call with Vapi MCP?**
You use the 'create_phone_call' tool. You just need to provide the target phone number ID and details about who is calling for a successful outbound connection.

**Does Vapi MCP help me manage complex call flows?**
Yes, you can use 'list_squads' to see all defined multi-agent teams. This helps structure advanced conversational paths and ensure the right bots talk to each other.