How to Use the Vapi MCP in Windsurf

Q: How do I list all available voice assistants using Vapi in Windsurf?

Just ask your agent to use the listassistants tool. It pulls a list of every Voice AI assistant you've configured in Vapi, so you know exactly what personas are active.

Q: Can Vapi help me check call details when using Windsurf?

Absolutely. You can use getcalldetails to retrieve everything about a specific call, including transcripts and performance metrics. This is great for checking up on historical interactions.

Q: What data does the Vapi MCP Server touch regarding privacy in Windsurf?

This server touches transcripts. When you request details using getcalldetails, it accesses call transcripts. Always remember to manage access controls for this sensitive communication data.

Q: How does Vapi handle listing active calls in Windsurf?

The listcalls tool gives you a rundown of recent and currently active voice calls managed by Vapi. It’s the quick way to see if things are running or if they finished already.

Q: If I want to list all phone numbers, what do I use with Vapi in Windsurf?

Run listphonenumbers. This tool connects you directly to every phone number ID connected to your account within the Vapi system. It's the first step before making any outbound calls.

Manage Voice AI assistants and calls directly from Windsurf's Cascade agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Vapi MCP to Windsurf

Create your Vinkius account to connect Vapi to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Vapi with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Multi-Step Calling Sequences

Windsurf’s Cascade handles complex tasks automatically. You can tell it to 'Get the transcript for yesterday's call and then update the assistant persona.' It figures out the sequence, executing `get_call_details` followed by `update_assistant`. This means you don't have to prompt Windsurf for each step; it just gets it done.

Configure Voice AI Personas

Need a new voice assistant? Use the `create_assistant` tool to set up a persona. You provide the transcriber, model, and desired voice settings in a JSON string. After creation, you can use `list_assistants` to verify it's ready for action.

Initiate Live Voice Communications

Making calls is simple within your IDE flow. Use the `create_phone_call` tool when you need an outbound call started, providing just the phone number ID and customer details. If you just want a link to test before running it live, run `create_web_call` instead.

Setup guide

Set up Vapi MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Vapi MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Vapi payment history." If connected, Cascade will call the Vapi tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "vapi-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Vapi. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Vapi now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Vapi MCP in Windsurf

Just ask your agent to use the `list_assistants` tool. It pulls a list of every Voice AI assistant you've configured in Vapi, so you know exactly what personas are active.

Absolutely. You can use `get_call_details` to retrieve everything about a specific call, including transcripts and performance metrics. This is great for checking up on historical interactions.

This server touches `transcripts`. When you request details using `get_call_details`, it accesses call transcripts. Always remember to manage access controls for this sensitive communication data.

The `list_calls` tool gives you a rundown of recent and currently active voice calls managed by Vapi. It’s the quick way to see if things are running or if they finished already.

Run `list_phone_numbers`. This tool connects you directly to every phone number ID connected to your account within the Vapi system. It's the first step before making any outbound calls.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript