MCP VoiceAI WhiteLabel

🚀 How to update AWS MCP server

This project offers a comprehensive MCP server implementation tailored for the VoiceAI VAVicky AiAgency platform. It comes with a rich set of features for user management, API token management, assistant management, Twilio integration, and communication.

🚀 Quick Start

Update the MCP Server

Execute the following command to update the code on AWS, restart the MCP Server, and open the logs:

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

Exit the logs

To exit the logs, simply press:

Press CTRL+C

✨ Features

User Management

• Retrieve user data, including tokens and settings.
• Update White Label details such as name, description, domain, and color.
• Configure SMTP settings for custom email notifications.

API Token Management

• Update various API keys, including OpenAI, ElevenLabs, Deepseek, Google Gemini, and Open Router.

Assistant Management

• List all assistants and obtain specific assistant information.
• Create new assistants with comprehensive configurations, update existing ones, and delete assistants.
• Manage assistant files, get usage statistics and analytics, and chat with assistants.

Twilio Integration

• Connect or disconnect Twilio accounts, get available phone numbers, purchase phone numbers, manage existing numbers, and obtain usage statistics.

Communication

• Make individual or bulk phone calls, send SMS messages, cancel active calls, and monitor ongoing calls.

📦 Installation

1. Clone or create the project:

   mkdir vavicky-mcp-server
   cd vavicky-mcp-server
   

2. Create package.json:

   npm init -y
   npm install @modelcontextprotocol/sdk node-fetch
   

3. Create the server.js file using the provided code.

4. Set up environment variables:

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

5. Make the server executable:

   chmod +x server.js
   

💻 Usage Examples

Assistant Management

Claude, create a new voice assistant named 'Sales Bot' with OpenAI GPT-4 that can make phone calls and has a professional greeting.

Communication

Claude, send an SMS to +1234567890 using assistant ID 'assist_123' with the message 'Hello, this is a test message.'

Analytics

Claude, show me the usage statistics for all my assistants this month.

Phone Management

Claude, get me a list of available toll-free numbers in the US and purchase one for my business.

📚 Documentation

User Management Tools

• get_user: Retrieve user data, including tokens and settings.
• update_white_label: Update White Label branding.
• update_smtp: Configure email settings.

Token Management Tools

• update_openai_token: Set the OpenAI API key.
• update_elevenlabs_token: Set the ElevenLabs API key.
• update_deepseek_token: Set the Deepseek API key.
• update_gemini_token: Set the Gemini API key.
• update_openrouter_token: Set the Open Router API key.

Assistant Tools

• get_assistants: List all assistants.
• get_assistant: Get basic assistant information.
• get_one_assistant: Get complete assistant information.
• create_assistant: Create a new assistant.
• update_assistant: Update assistant settings.
• delete_assistant: Remove an assistant.
• get_assistant_files: List assistant files.
• delete_assistant_file: Remove an assistant file.
• get_assistant_usage: Get usage statistics.
• get_assistants_token_usage: Get token usage across assistants.
• get_dashboard_assistant: Get the dashboard assistant.
• chat_with_assistant: Chat with an assistant.

Twilio Tools

• connect_twilio: Connect a Twilio account.
• disconnect_twilio: Disconnect a Twilio account.
• get_twilio_numbers: List phone numbers.
• get_available_numbers: Find available numbers.
• buy_twilio_number: Purchase a phone number.
• update_twilio_number: Configure number settings.
• get_twilio_usage: Get Twilio usage statistics.

Communication Tools

• make_call: Make a phone call.
• make_bulk_call: Make bulk calls.
• get_calls_in_progress: List active calls.
• cancel_call: Cancel an active call.
• send_sms: Send an SMS message.

🔧 Technical Details

Error Handling

The server is equipped with comprehensive error handling for API authentication errors, invalid parameters, network connectivity issues, and API rate limiting.

Development

To run the server in development mode with debugging, use the following command:

npm run dev

Security

• API keys are passed via environment variables.
• All requests include proper authentication headers.
• Input validation is performed on all parameters.

📄 License

This MCP server follows the same licensing as the original Vavicky n8n node implementation.

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.