Skip to content
MCP server

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.

Connect your AI assistant

After signing in, copy a ready-made prompt into your assistant's chat. The technical steps below are optional.

Manual setup

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 AI assistant - 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:

json
{
  "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

bash
claude mcp add --header 'Authorization: Bearer vk_YOUR_KEY' --transport http --scope user volai 'https://volai.cz/mcp'

After installing, replace vk_YOUR_KEY with your key from the AI assistant setup in 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.json inside a repository applies only to that project; ~/.cursor/mcp.json is global for your whole account. Heads up: the file holds your API key, so keep the project one in .gitignore instead 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.json for a single project), as the value of the Authorization field. To rotate it, delete the old key in the portal under AI assistant - 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?
Tools such as send_sms, get_call, and buy_number cover calls, SMS, numbers, voice agents, webhooks, and other account features. The complete current list is on /docs/mcp.

Try it now

Sign up and get 50 CZK in credit on top.