volai in Windsurf: phone and SMS over MCP
Cascade, the agent built into Windsurf, gets phone calls and SMS through the volai MCP server. Just say what you want, and it picks the right tool and calls it.
1Get an API key
Sign up for volai and verify your email first - without it, no credit lands on the account. In the portal under API and MCP, create a new key; it starts with vk_ and works for the REST API too.
2Add the server to Windsurf
Save the config to ~/.codeium/windsurf/mcp_config.json - same shape as Cursor, just with a serverUrl field instead of url:
{
"mcpServers": {
"volai": {
"serverUrl": "https://volai.cz/mcp",
"headers": {
"Authorization": "Bearer vk_YOUR_KEY"
}
}
}
}3Refresh the server list
In the Cascade panel, under MCP servers, refresh the list - volai should show up among the connected servers with its tools.
4Try it in Cascade
Type "Call me and try the role of a cafe receptionist" - Cascade calls the make_call tool with a systemPrompt parameter and starts a trial call, no number of your own required. You need a verified email for it, and it caps out at 3 calls a day per account.
Or add volai to your editor in one click
Claude Code
claude mcp add --transport http volai https://volai.cz/mcp \
--header "Authorization: Bearer vk_YOUR_KEY"After installing, replace vk_YOUR_KEY with your key from the API and MCP section of the portal.
What you can do with it
Place a trial call from Cascade
make_call with systemPrompt starts a trial call from volai's shared demo number - no agent to set up, no number to buy. Needs a verified email, and tops out at three calls a day per account.
Text yourself when a job finishes
The Cascade agent sends a text with the send_sms tool as soon as a long task completes - even as the last step of a saved workflow, no webhook to run.
List and summarize recent calls
list_calls and get_call return call history and transcripts straight into the editor, no portal required.
Frequently asked questions
- Why does Windsurf use a different field name than Cursor?
serverUrlinstead ofurlis the only difference - both fields point at the same address,https://volai.cz/mcp.- Do I need to restart Windsurf after saving the config?
- Usually refreshing the server list in the Cascade panel is enough; if volai doesn't show up, restart the app.
- Can I use a different key per project in Windsurf?
- Not directly - unlike Cursor, Windsurf only has one global config,
~/.codeium/windsurf/mcp_config.json, with no project-level file next to it. If you need a different key for a different project, edit theAuthorizationvalue in that file by hand before switching, then refresh the server list in the Cascade panel so the change takes effect. - What can I do from Windsurf?
- The full set of 31 tools - things like
list_calls,make_call, orsend_sms- for calls, SMS, numbers, voice agents, and webhooks. The full list is on/docs/mcp.