Vavicky

You can run and manage the Vavicky MCP Server to provide a complete MCP implementation for the VoiceAI VAVicky AiAgency platform. This server exposes rich user, token, assistant, Twilio, and communication capabilities through a centralized MCP endpoint, making it easy to connect clients and automate workflows.

How to use

You will connect your MCP client to the public streamable MCP endpoint to manage users, tokens, assistants, and communications. Use the HTTP URL to access the MCP server from your client and perform actions such as creating assistants, updating API keys, connecting Twilio, and sending messages or making calls. You can also monitor usage statistics and analytics for your assistants.

How to install

Prerequisites you need before installation: you should have Node.js and npm installed on your system. You also need a valid API key for the Vavicky service.

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

# 2. Initialize a package.json and install dependencies
npm init -y
npm install @modelcontextprotocol/sdk node-fetch

# 3. Create the server file
# Place your server code in a file named server.js

4. Set up environment variables. Create the environment file and add your API key.

echo 'VAVICKY_API_KEY=your-api-key-here' > .env

5. Make the server executable so you can launch it directly.

chmod +x server.js

Additional configuration and operation notes

Public MCP URL to access the server remotely is https://backend.vavicky.com/mcp. Use this URL for client connections unless you deploy a private instance.

To update the MCP server code on AWS and restart the server while viewing logs, run these commands from the server directory:

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

Security and maintenance

Environment variables are used to provide API keys. Ensure you keep these keys secret and rotate them as needed. All requests include proper authentication headers, and input validation is performed on all parameters.

Tool and endpoint capabilities

The MCP server exposes a comprehensive set of tools to manage users, tokens, assistants, Twilio integration, and communications. You can perform tasks ranging from retrieving user data to creating and managing assistants, purchasing phone numbers, and sending or scheduling communications.

Available tools

get_user

Retrieve user data including tokens and settings.

update_white_label

Update branding details for white-labeling, 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 synthesis.

update_deepseek_token

Set the Deepseek API key for data tasks.

update_gemini_token

Set the Google Gemini API key.

update_openrouter_token

Set the Open Router API key.

get_assistants

List all existing assistants.

get_assistant

Get basic information about a specific assistant.

get_one_assistant

Get complete information for a specific assistant.

create_assistant

Create a new assistant with a full configuration.

update_assistant

Update settings for an existing assistant.

delete_assistant

Delete an existing 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 a specific assistant.

get_assistants_token_usage

Get token usage across all assistants.

get_dashboard_assistant

Retrieve the dashboard view for an assistant.

chat_with_assistant

Chat with an assistant.

connect_twilio

Connect a Twilio account.

disconnect_twilio

Disconnect a Twilio account.

get_twilio_numbers

List phone numbers associated with Twilio.

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 a phone call using an assistant.

make_bulk_call

Initiate multiple calls in a batch.

get_calls_in_progress

List active calls in progress.

cancel_call

Cancel an ongoing call.

send_sms

Send an SMS message.