volai in Cursor: phone and SMS as an MCP tool
In Agent mode, Cursor gets phone calls and SMS through the volai MCP server. Just say what you want - it picks the right tool and calls it, no portal required.
1Get an API key
Sign up for volai and confirm the verification email, or the signup credit never lands. Then create a new key in the portal under API and MCP - it starts with vk_ and works for the REST API too.
2Add the server to Cursor
Save the config to ~/.cursor/mcp.json (or .cursor/mcp.json for a single project) and replace the key with your own:
{
"mcpServers": {
"volai": {
"url": "https://volai.cz/mcp",
"headers": {
"Authorization": "Bearer vk_YOUR_KEY"
}
}
}
}3Check the connection
In Cursor's settings, under the MCP section, volai shows up in the server list as connected, with its tools listed underneath.
4Try it in chat
In Agent mode, type "Text my number that the build passed" in chat - Cursor picks the send_sms tool and sends it.
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
Build and test notifications
Have the agent call or text you when a script finishes or a test fails - no webhook or extra server to run.
Spin up a line for a new prototype
buy_number and create_agent right from chat, when a prototype earns its own phone number.
Debug calls without leaving the editor
get_call returns the transcript and summary straight into the editor, no portal required.
Frequently asked questions
- Do I need to restart Cursor after adding the server?
- Cursor usually picks up a new server as soon as you save
mcp.json; if the tools don't show up, reload the window. - Can I set this up for just one project?
- Yes -
.cursor/mcp.jsoninside a repository applies only to that project;~/.cursor/mcp.jsonis global for your whole account. Heads up: the file holds your API key, so keep the project one in.gitignoreinstead of committing it. - Where does Cursor store the key, and how do I rotate it later?
- The key sits in plain JSON in
~/.cursor/mcp.json(or.cursor/mcp.jsonfor a single project), as the value of theAuthorizationfield. To rotate it, delete the old key in the portal under API and MCP - it stops working immediately - and paste the new one into the same file; Cursor picks it up on its own once you save. - What can I do from Cursor?
- The full set of 31 tools - things like
send_sms,get_call, orbuy_number- for calls, SMS, numbers, voice agents, and webhooks. The full list is on/docs/mcp.