Vavicky

You deploy and run the Vavicky MCP Server to manage VoiceAI assistants, tokens, communications, and Twilio integration via MCP. It provides both a remote API endpoint and a local, server-based runtime you can run on your infrastructure, enabling dynamic configuration, monitoring, and control of your MCP-enabled workflows.

How to use

You can access the MCP server through a public HTTP URL to connect your MCP client or use a local stdio server for on-premises deployments. The HTTP endpoint serves as the remote MCP connection, while the local runtime allows you to run the MCP server directly on your machine or server. Use whichever method fits your deployment strategy, then use the available tools to manage users, tokens, assistants, Twilio integration, and communications.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

# 1. Create a project directory
mkdir vavicky-mcp-server
cd vavicky-mcp-server

# 2. Initialize with npm and install required packages
npm init -y
npm install @modelcontextprotocol/sdk node-fetch

# 3. Create the server entry point (server.js) and add your runtime code here
# 4. Set up environment variables
echo 'VAVICKY_API_KEY=your-api-key-here' > .env

# 5. Make the server executable if you plan to run it directly
chmod +x server.js

Additional information

Public MCP URL for remote access: https://backend.vavicky.com/mcp.

To update the MCP server on AWS and restart the service while viewing logs, run the following from your project root that contains the MCP code:

cd MCP-VoiceAI-WhiteLabel/ && git pull && pm2 restart 6 && pm2 logs 6

To exit the logs, press CTRL+C.

## Configuration and runtime notes

Claude Desktop can be configured to interface with the MCP server. Add the following configuration to your Claude Desktop config file to point to your local MCP server run configuration.

"mcpServers": { "vavicky": { "command": "node", "args": ["/absolute/path/to/your/vavicky-mcp-server/server.js"], "env": { "VAVICKY_API_KEY": "your-vavicky-api-key-here" } } }

## Security and maintenance

API keys are passed via environment variables. All requests should include proper authentication headers. Perform input validation on all parameters and maintain up-to-date dependencies to minimize security risks.

## Available tools

### get\_user

Retrieve user data including tokens and settings.

### update\_white\_label

Update White Label branding details such as name, description, domain, and color.

### update\_smtp

Configure SMTP settings for custom email notifications.

### update\_openai\_token

Set the OpenAI API key used by assistants.

### update\_elevenlabs\_token

Set the ElevenLabs API key for voice capabilities.

### update\_deepseek\_token

Set the Deepseek API key.

### update\_gemini\_token

Set the Google Gemini API key.

### update\_openrouter\_token

Set the Open Router API key.

### get\_assistants

List all assistants.

### get\_assistant

Get basic assistant information.

### get\_one\_assistant

Get complete details for a single assistant.

### create\_assistant

Create a new assistant with full configuration.

### update\_assistant

Update an existing assistant.

### delete\_assistant

Remove an assistant.

### get\_assistant\_files

List files associated with an assistant.

### delete\_assistant\_file

Remove a file from an assistant.

### get\_assistant\_usage

Get usage statistics for an assistant.

### get\_assistants\_token\_usage

Get token usage across all assistants.

### get\_dashboard\_assistant

Retrieve the dashboard-focused assistant.

### chat\_with\_assistant

Chat with an assistant.

### connect\_twilio

Connect a Twilio account.

### disconnect\_twilio

Disconnect Twilio from the MCP server.

### get\_twilio\_numbers

List Twilio numbers owned by your account.

### get\_available\_numbers

Find available phone numbers for purchase.

### buy\_twilio\_number

Purchase a Twilio phone number.

### update\_twilio\_number

Configure settings for a Twilio number.

### get\_twilio\_usage

Get Twilio usage statistics.

### make\_call

Make an individual phone call.

### make\_bulk\_call

Place multiple calls in a single operation.

### get\_calls\_in\_progress

List active calls.

### cancel\_call

Cancel an ongoing call.

### send\_sms

Send an SMS message.