list_assistantsLABSCO SUMMARY
Stand up a phone agent and place the call, from one place.
It covers the whole loop rather than just one step: create and configure an assistant, give it custom tools that call your own APIs, then place the outbound call and read back what happened. create_call taking a schedule is the useful detail — an outbound campaign or a callback can be queued rather than fired the instant you ask.
What it is
Vapi's official server for building AI voice assistants and phone agents: tools to manage assistants, place and inspect calls, read phone numbers, and define the custom function-calling tools an assistant can use.
What you get
- Assistants managed end to end: list_assistants, get_assistant by ID, create_assistant and update_assistant
- Calls: list_calls for history, get_call for one call's details, and create_call to start an outbound call immediately or on a schedule
- Phone numbers: list_phone_numbers and get_phone_number for the numbers on your account
- Custom function-calling tools: list_tools, get_tool, create_tool to integrate an API into an assistant, and update_tool
Requirements
A Vapi API key from the Vapi dashboard, held in VAPI_TOKEN. Node, run as npx @vapi-ai/mcp-server over stdio, or connect to the hosted server at https://mcp.vapi.ai/mcp with an Authorization: Bearer header.
Setup effort
One command plus a key — npx -y @vapi-ai/mcp-server, then supply credentials
USE CASES
01
Setting up a voice assistant
Create the assistant, give it a custom tool that reaches your API, and update its configuration as you tune the behavior.
02
Placing an outbound call
Pick the assistant and a phone number, start the call now or schedule it for later, and read the call details once it completes.
03
Reviewing what your agents did
List the call history and open the ones worth inspecting to see how each conversation went.
13 tools
Listed in project docs. Your client may show a different list.
get_assistantcreate_assistantupdate_assistantlist_callsget_callcreate_calllist_phone_numbersget_phone_numberlist_toolsget_toolcreate_toolupdate_toolBEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation.
Requires
- npx on PATH
- VAPI_TOKEN in your environment
Where it runs
Of the 2 documented clients, 1 runs the server on your machine and 1 connects to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y @vapi-ai/mcp-serverHosted endpoint
ENDPOINT URL
https://mcp.vapi.ai/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add -e VAPI_TOKEN=<YOUR_VAPI_TOKEN> vapi -- npx -y @vapi-ai/mcp-serverClaude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"vapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.vapi.ai/mcp",
"--header",
"Authorization: Bearer ${VAPI_TOKEN}"
],
"env": {
"VAPI_TOKEN": "<YOUR_VAPI_TOKEN>"
}
}
}
}
