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 | balance | Get your Vonage account balance | | | list-applications | List all applications attached to your API key with their configurations and capabilities | | | create-application | Create a new Vonage application with a specified name | | | list-purchased-numbers | List telephone numbers associated with your account and their metadata | | Number Management | link-number-to-vonage-application | Link an owned number to a specific Vonage Application | | Messaging & Communication | SMS | Send SMS messages using Vonage | | | whatsapp-send-text | Send text messages via WhatsApp | | | whatsapp-send-text-with-sms-failover | Send a WhatsApp text message with automatic SMS failover | | | rcs-send-text | Send text messages via RCS | | | rcs-send-text-with-sms-failover | Send an RCS text message with automatic SMS failover | | | outbound-voice-message | 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

• VS Code
• Cursor
• Windsurf
• Claude Desktop

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 inforamtion is sent anywhere: https://mylight.work/private-key-to-environment-variable