home / mcp / vavicky mcp server

Vavicky MCP Server

Provides a complete MCP server for the VoiceAI VAVicky AiAgency platform, handling users, tokens, assistants, Twilio, and communications via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aiagency-now-mcp-voiceai-whitelabel": {
      "url": "https://backend.vavicky.com/mcp",
      "headers": {
        "VAVICKY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

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.