This MCP server enables comprehensive voice AI assistant management and communication capabilities through Claude Desktop for the Vavicky AiAgency platform.
Core Capabilities:
User & White Label Management - Retrieve user account data, configure white-label branding (name, description, domain, colors), and set up custom SMTP settings for email notifications
API Token Management - Update API keys for OpenAI, ElevenLabs, Deepseek, Google Gemini, and Open Router platforms
AI Assistant Management - Create, read, update, and delete voice/text assistants with extensive configuration including:
AI platform and model selection
Assistant type (Text Only, Voice Only, Text & Voice, Voice & Text)
Custom prompts and voice parameters (ElevenLabs voices, OpenAI Realtime voices)
Call limits, temperature settings, and timing parameters
File and knowledge base management
Integration with Google Calendar, GoHighLevel CRM, and custom webhooks
Direct chat interface with text or audio responses
Twilio Phone System - Connect/disconnect accounts, search and purchase phone numbers (local, toll-free, mobile), manage number configurations, and view usage statistics
Communication - Make individual and bulk phone calls, send SMS messages, monitor active calls in real-time, and cancel ongoing calls
Analytics & Monitoring - Track assistant usage statistics, token consumption across all assistants, Twilio usage metrics, and dashboard analytics
Provides API key management for ElevenLabs text-to-speech services used in voice assistant implementations
Allows configuration of Google Gemini API keys for integrating Gemini AI models into voice assistants
Enables management of OpenAI API keys and integration with OpenAI GPT models for voice assistant creation and configuration
Comprehensive integration for managing Twilio accounts, phone numbers, making calls, sending SMS messages, and tracking communication usage and analytics
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VoiceAI-MCP-VAVickycreate a new voice assistant named 'Customer Support Bot' that can handle calls and send SMS"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
How to update AWS MCP server
Public Streamable HTTP URL MCP Server
Related MCP server: YaVendió Tools
Update the MCP Server
This command will update the code on AWS and restart the MCP Server and it opens the logs.
Exit the logs
Vavicky MCP Server
Complete MCP server implementation for the VoiceAI VAVicky AiAgency platform.
Features
User Management
Get user data including tokens and settings
Update White Label details (name, description, domain, color)
Update SMTP settings for custom email notifications
API Token Management
Update OpenAI API Key
Update ElevenLabs API Key
Update Deepseek API Key
Update Google Gemini API Key
Update Open Router API Key
Assistant Management
Get all assistants
Get specific assistant information
Create new assistants with comprehensive configuration
Update existing assistants
Delete assistants
Manage assistant files
Get usage statistics and analytics
Chat with assistants
Twilio Integration
Connect/disconnect Twilio accounts
Get available phone numbers
Purchase phone numbers
Manage existing numbers
Get usage statistics
Communication
Make individual phone calls
Make bulk phone calls
Send SMS messages
Cancel active calls
Monitor calls in progress
Installation
Clone or create the project:
mkdir vavicky-mcp-server cd vavicky-mcp-serverCreate package.json:
npm init -y npm install @modelcontextprotocol/sdk node-fetchCreate the server.js file with the provided code
Set up environment variables:
echo 'VAVICKY_API_KEY=your-api-key-here' > .envMake the server executable:
chmod +x server.js
Claude Desktop Configuration
Add this to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json
Usage Examples
Once configured, you can use these tools in Claude:
Assistant Management
Communication
Analytics
Phone Management
Tool Reference
User Management Tools
get_user- Get user data including tokens and settingsupdate_white_label- Update White Label brandingupdate_smtp- Configure email settings
Token Management Tools
update_openai_token- Set OpenAI API keyupdate_elevenlabs_token- Set ElevenLabs API keyupdate_deepseek_token- Set Deepseek API keyupdate_gemini_token- Set Gemini API keyupdate_openrouter_token- Set Open Router API key
Assistant Tools
get_assistants- List all assistantsget_assistant- Get basic assistant infoget_one_assistant- Get complete assistant infocreate_assistant- Create new assistantupdate_assistant- Update assistant settingsdelete_assistant- Remove assistantget_assistant_files- List assistant filesdelete_assistant_file- Remove assistant fileget_assistant_usage- Get usage statsget_assistants_token_usage- Get token usage across assistantsget_dashboard_assistant- Get dashboard assistantchat_with_assistant- Chat with assistant
Twilio Tools
connect_twilio- Connect Twilio accountdisconnect_twilio- Disconnect Twilioget_twilio_numbers- List phone numbersget_available_numbers- Find available numbersbuy_twilio_number- Purchase phone numberupdate_twilio_number- Configure number settingsget_twilio_usage- Get Twilio usage stats
Communication Tools
make_call- Make phone callmake_bulk_call- Make bulk callsget_calls_in_progress- List active callscancel_call- Cancel active callsend_sms- Send SMS message
Error Handling
The server includes comprehensive error handling:
API authentication errors
Invalid parameters
Network connectivity issues
API rate limiting
Development
To run in development mode with debugging:
Security
API keys are passed via environment variables
All requests include proper authentication headers
Input validation is performed on all parameters
Support
For issues with the Vavicky platform, visit: https://github.com/Business-On-Steroids/n8n-nodes-voiceai For MCP-related issues, refer to the Anthropic MCP documentation.
License
This MCP server follows the same licensing as the original Vavicky n8n node implementation.