# Vonage MCP

> Vonage MCP connects your AI agent to global communications, letting you send messages across SMS, WhatsApp, and Viber channels. It also handles virtual number management and two-factor authentication (2FA) workflows, all from chat commands. You can check account credits, determine international pricing, and manage webhook updates without ever logging into a dashboard.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** programmable-sms, whatsapp-api, 2fa, identity-verification, voice-api, multi-channel-messaging

## Description

This MCP lets your AI agent become a full-scale communications command center. Instead of manually logging into separate dashboards to send a text or check an account balance, you simply ask your agent to handle it. You can trigger outbound messaging—whether that's a quick SMS update, a WhatsApp alert, or a Viber service message—by giving simple natural language prompts. Beyond sending messages, the MCP helps manage identity verification by initiating and checking One-Time Passwords (OTPs) for user accounts. It gives you visibility into your infrastructure too; list all rented numbers and even update their specific inbound webhooks using chat commands. Because Vinkius hosts this entire library of tools, your agent has access to global pricing data, letting you estimate communication costs before a campaign launches. It’s about moving complex, multi-step comms workflows directly into your conversational AI client.

## Tools

### cancel_verification_request
Aborts an identity verification request that is currently active for a user's number.

### get_account_balance
Retrieves the current monetary credit balance associated with your Vonage account.

### get_country_pricing
Provides the outbound SMS pricing for a specific country code you supply.

### list_rented_numbers
Generates a list of every virtual phone number currently rented under your account.

### send_sms
Sends an outbound text message (SMS) to a target phone number using a specified sender name.

### send_viber_message
Transmits a service message through the Viber messaging platform using your publisher ID.

### send_whatsapp_message
Sends an outbound message via WhatsApp, requiring a verified Business Number as the sender.

### update_number_webhook
Changes the inbound SMS callback URL for a specific virtual number using its E.164 format.

### check_verification_code
Verifies if a user-submitted One-Time Password (OTP) matches an active identity verification request.

### start_verification
Initiates the 2FA process by sending a unique OTP code to a target number with your brand name.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +123456789 saying 'Your order is ready for pickup!'.
```

**Response:** 
```
I've sent the SMS to +123456789 via Vonage. Message: 'Your order is ready for pickup!'. The message was successfully dispatched (Message ID: msg-abc).
```

**Prompt:** 
```
Start a verification for number +123456789 with brand 'MyCoolApp'.
```

**Response:** 
```
Identity verification started for +123456789. The OTP code has been sent. Your Request ID is 'req-xyz'. Please let me know the code when you receive it to complete the check.
```

**Prompt:** 
```
What is my current account balance and the SMS price for the UK?
```

**Response:** 
```
Your current Vonage balance is 42.50 EUR. For the United Kingdom (GB), the outbound SMS price is approximately 0.045 EUR per message. You have enough credit for roughly 944 messages.
```

## Capabilities

### Send messages across multiple channels
You can send outbound alerts via SMS, WhatsApp Business, or Viber from a single prompt.

### Manage user verification codes (2FA)
The MCP handles starting the 2FA process by sending an OTP code and then checks if the user submits the correct code to validate their account.

### Monitor billing and number status
You retrieve your real-time credit balance, check outbound SMS pricing for any country, or list every virtual phone number tied to the account.

### Update Number Webhooks
The MCP lets you programmatically change the callback URL for a specific rented virtual number.

## Use Cases

### Handling a new user sign-up
A customer asks their agent to verify their account. The agent automatically runs start_verification using the provided phone number, sends the OTP, and then waits for the user to reply with the code, completing the process via check_verification_code.

### Running a regional marketing campaign
The marketing lead asks the agent to estimate costs. The agent uses get_country_pricing with the ISO code for Brazil (BR) and then suggests an estimated budget based on 10,000 messages.

### Addressing a number routing failure
An ops manager notices an inbound webhook is pointing to the old system. They simply tell the agent to run update_number_webhook using the E.164 format for the affected number, fixing it instantly.

### Sending a multi-channel alert
The support team needs to notify an employee of a policy change. The agent sends the same message simultaneously via send_whatsapp_message and send_sms, ensuring maximum reach across preferred channels.

## Benefits

- Centralized Comms: Instead of managing separate integrations for SMS, WhatsApp, and Viber, the Vonage MCP lets your agent handle all three channels from one prompt. This means faster support response times and fewer tools to track.
- Proactive Security: You can automate user onboarding by having your agent initiate a two-factor authentication flow using start_verification and then complete it with check_verification_code, making account setup instant.
- Cost Visibility: Quickly understand operational costs. Use get_account_balance to check spending limits or run get_country_pricing for new markets before committing to a campaign.
- Infrastructure Control: Need to redirect where messages come in? The MCP lets you update_number_webhook directly via chat, eliminating the need to manually navigate the number management portal.
- Efficiency Boost: By integrating this into your Vinkius catalog setup, you stop logging into multiple vendor dashboards. Your AI client becomes the single control point for all communication needs.

## How It Works

The bottom line is that your conversational AI client runs all these complex comms tasks directly, without needing manual logins or dashboard navigation.

1. Subscribe to this Vonage MCP and provide your API Key and Secret credentials.
2. Your AI agent uses these keys to access the communication tools, treating them like simple functions you call in chat.
3. The agent executes the required action—like sending a WhatsApp message or checking account credits—and reports the result back to you.

## Frequently Asked Questions

**How do I send a WhatsApp message using Vonage MCP?**
You use the send_whatsapp_message tool. Just make sure your sender number is a verified WhatsApp Business Number, and then tell your agent who you want to message.

**What does start_verification do with the Vonage MCP?**
It begins the two-factor authentication process by sending an OTP code to the target number. After that, you must use check_verification_code to complete the validation using the received code.

**Can I list my numbers with Vonage MCP?**
Yes, running list_rented_numbers pulls up a comprehensive list of every virtual phone number currently tied to your account, helping you keep track of all assets.

**How do I check pricing for different countries using Vonage MCP?**
You use get_country_pricing and provide the ISO 3166-1 alpha-2 country code. This gives an accurate estimate of the outbound SMS cost for that region.

**What if I need to change a number's callback URL?**
You use the update_number_webhook tool. You just need to provide the E.164 formatted number and the new inbound SMS callback URL you want it to point to.