Vonage API Bindings MCP Server
About
This server integrates a variety of Vonage's APIs as tools to help developers work with their applications.
Details
- Author
- Vonage-Community
- Downloads
- 367
- Categories
- Developer Tools
Jump to
- Check Vonage account balance
- List, create, and link Vonage applications
- List and link purchased telephone numbers
- Send SMS messages via Vonage
- Send WhatsApp messages with optional SMS failover
- Send RCS messages with optional SMS failover
- Send outbound voice messages
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Vonage API Bindings MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server in your MCP client by adding a JSON entry with "type": "stdio", "command": "npx", "args": ["-y", "@vonage/vonage-mcp-server-api-bindings"], and set required environment variables (VONAGE_APPLICATION_ID, VONAGE_PRIVATE_KEY64, VONAGE_API_KEY, VONAGE_API_SECRET, VONAGE_VIRTUAL_NUMBER, VONAGE_WHATSAPP_NUMBER, RCS_SENDER_ID). Then invoke tools using natural language prompts such as “Can you check my Vonage account balance?”.
balance
Get your Vonage Account balance
SMS
Send SMS messages with Vonage
whatsapp-send-text
Send a text message via WhatsApp using Vonage Messages API
whatsapp-send-text-with-sms-failover
Send a WhatsApp text message with automatic SMS failover using the Vonage Messages API failover feature
rcs-send-text
Send a text message via RCS using Vonage Messages API
rcs-send-text-with-sms-failover
Send an RCS text message with automatic SMS failover using the Vonage Messages API failover feature
outbound-voice-message
Send an outbound voice message with Vonage
list-applications
List out the applications that are attached to my API key
create-application
Create a new Vonage application with a specified name
list-purchased-numbers
List of the telephone numbers that are currently associated with my account and their metadata
search-available-numbers
Search for available phone numbers that can be purchased from Vonage in a specific country
link-number-to-vonage-application
Link an owned number to the assigned Vonage Application
get-records-report
Retrieve a report of activity records from the Vonage Reports API. Supports date-based queries (e.g. "all SMS sent over the last week") and ID-based queries (e.g. "report for Call ID 1234-abcd"). For date-based queries provide product, direction (required for SMS/MESSAGES), and optionally date_start/date_end. For ID-based queries provide product and id (comma-separated UUIDs, max 20).
make-chart
Generates an interactive Chart.js chart from data.
save-chart
INTERNAL SYSTEM TOOL. DO NOT CALL. This tool is strictly for the frontend UI iframe to execute native filesystem saves. You (the AI model) do not have access to the base64 canvas data required to use this tool. Any attempt by the AI to call this tool will fail. Ignore this tool entirely.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"vonage api bindings mcp server": {
"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>"
}
}
}
}
}McpServers
{
"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>"
}
}
}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 information is sent anywhere:
> https://mylight.work/private-key-to-environment-variable
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
