Provides tools for managing Vonage account operations including balance checks, application management, phone number management, and multi-channel messaging capabilities (SMS, WhatsApp, RCS, and voice messages with failover support).
Enables sending WhatsApp text messages through Vonage's API, with support for SMS failover when WhatsApp delivery is unavailable.
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., "@vonage-mcp-server-api-bindingssend an SMS to +15551234567 saying 'Your appointment is confirmed for tomorrow at 2 PM'"
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.
Vonage API MCP server
Available Tools
This MCP server provides access to various Vonage API functionalities through the following tools:
Category | Tool Name | Description |
Account Management |
| Get your Vonage account balance |
| List all applications attached to your API key with their configurations and capabilities | |
| Create a new Vonage application with a specified name | |
| List telephone numbers associated with your account and their metadata | |
Number Management |
| Link an owned number to a specific Vonage Application |
Messaging & Communication |
| Send SMS messages using Vonage |
| Send text messages via WhatsApp | |
| Send a WhatsApp text message with automatic SMS failover | |
| Send text messages via RCS | |
| Send an RCS text message with automatic SMS failover | |
| Send outbound voice messages with Vonage |
Usage Examples
Check Account Balance
Can you check my Vonage account balance?List Your Phone Numbers
Can you list out the numbers that I own for Vonage?List Applications
Can you list out the applications on my account?Create a New Application
Can you create a new Vonage application called "My Chat App"?Or let the system suggest a name:
Can you create a new Vonage application?Send an SMS
Can you send an SMS to +1234567890 with the message "Hello from Vonage!"?Send a WhatsApp Message
Can you send a WhatsApp message to +1234567890 with the message "Hello from Vonage over WhatsApp!"?Send a WhatsApp Message with SMS Failover
Can you send a WhatsApp message with SMS failover to +1234567890 saying "Hello from Vonage with failover!"?Send an RCS Message
Can you send an RCS message to +1234567890 with the message "Hello from Vonage via RCS!"?Send an RCS Message with SMS Failover
Can you send an RCS message with SMS failover to +1234567890 saying "Hello from Vonage RCS with fallback!"?Set up the MCP server
The details of the MCP server should look like this.
"vonage-mcp-server-api-bindings": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vonage/vonage-mcp-server-api-bindings"
],
"env": {
"VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
"VONAGE_PRIVATE_KEY64": "<YOUR_VONAGE_PRIVATE_KEY64>",
"VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
"VONAGE_API_SECRET": "<YOUR_VONAGE_API_SECRET>",
"VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>",
"VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>",
"RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>"
}
}Right now, we only use a base64 encoded Private Key. I created a tool that will convert the private key file into the encoded string that you can copy and paste. Everything is done in your browser, no information is sent anywhere: https://mylight.work/private-key-to-environment-variable