# Vonage MCP for AI Agents AI Agent Connect > Vonage MCP connects your communications platform to your AI agent. It lets you send SMS, WhatsApp, and Viber messages, manage virtual numbers, and handle 2FA verification directly through your chat interface. No more switching tabs to send a single text. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_5z7FDCidUAghmdCAFieZtiZG4HkeoJydVAWLaua8/ai-agent-connect - **Tags:** programmable-sms, whatsapp-api, 2fa, identity-verification, voice-api, multi-channel-messaging ## Description This Vonage MCP connects your account to any AI agent so you can handle global communications through a chat interface. Instead of logging into a separate dashboard to send a single text, you can just tell your agent what to do. You can send messages across SMS, WhatsApp Business, and Viber, or start identity verification requests to secure your users. It also handles the common tasks like checking your real-time credit balance, looking up outbound pricing for different countries, and updating inbound webhooks for your virtual numbers. Because this is part of the Vinkius catalog, you get this functionality ready to go alongside your other tools. Your agent becomes a command center where you can manage your entire communication flow without leaving your workspace. You can check if you have enough credit for a campaign or see the costs for a specific region before you start. It turns a multi-step process into a single conversation, letting you focus on your actual work while the agent handles the heavy lifting of reaching out to your customers or partners. ## Tools ### get_account_balance Shows your current Vonage credit balance so you don't run out mid-campaign. It helps you keep a pulse on spending. ### get_country_pricing Tells you how much it costs to send an SMS to a specific country. Use this to estimate costs before a big launch. ### list_rented_numbers Shows every virtual phone number currently attached to your account. It gives you a quick bird's-eye view of your fleet. ### check_verification_code Validates the OTP code a user just typed in to confirm their identity. This completes the security check for your app. ### send_sms Sends an outbound text message to a specific phone number using a sender name. It works for quick updates or alerts. ### send_viber_message Sends a Viber service message using your specific Publisher ID. This keeps your Viber communications organized. ### cancel_verification_request Stops an active verification request if a user changes their mind. This is useful for cleaning up old requests. ### send_whatsapp_message Sends a WhatsApp message through your verified business number. It lets you reach customers on a platform they use daily. ### update_number_webhook Changes the URL where your virtual number sends inbound SMS data. Use this to point messages to the right endpoint. ### start_verification Sends a new OTP code to a target number to begin a 2FA process. It's the first step in securing a new user account. ## Prompt Examples **Prompt:** ``` Send an SMS to +15550102030 saying 'Your code is 4492'. ``` **Response:** ``` I've sent the SMS to +15550102030. **Message Details:** - **Content:** 'Your code is 4492' - **Status:** Successfully dispatched - **Message ID:** msg-982341 Let me know if you need me to send anything else! ``` **Prompt:** ``` What's the cost for an SMS to Germany? ``` **Response:** ``` The current outbound SMS pricing for Germany (DE) is as follows: | Country | ISO Code | Price per SMS | | :--- | :--- | :--- | | Germany | DE | 0.042 EUR | Would you like me to estimate the cost for a specific number of messages? ``` **Prompt:** ``` Start a verification for +15559998888 with the brand 'SecureApp'. ``` **Response:** ``` Identity verification has been started for +15559998888. - **Brand:** SecureApp - **Request ID:** req-7721-x - **Status:** OTP code sent successfully. Please let me know the code once the user provides it so I can verify it for you. ``` ## Capabilities ### Send multi-channel messages Send outbound texts across SMS, WhatsApp, and Viber through your AI client. ### Verify user identities Start and check OTP codes to secure accounts without manual entry. ### Manage virtual numbers List and update webhooks for all your rented phone numbers in one place. ### Track account spending Check your current credit balance and real-time spending via chat. ### Get international pricing Look up outbound SMS costs for any country to plan your budget. ## Use Cases ### Rapid OTP delivery for support A user can't log in. The agent asks the AI to send a new OTP via start_verification to get them back into their account immediately. ### Global campaign cost estimation A marketing manager asks the AI to estimate the cost of a 10k message blast to France using get_country_pricing before finalizing the budget. ### Webhook management for developers A developer needs to see if their webhook is firing and uses update_number_webhook to point it to a local URL for testing. ### Real-time balance monitoring An ops lead wants to see all active numbers and current balance using list_rented_numbers and get_account_balance during a high-traffic event. ## Benefits - Stop switching tabs by sending SMS and WhatsApp messages directly from your chat window using send_sms and send_whatsapp_message. - Get instant pricing for international campaigns by checking specific costs with get_country_pricing. - Secure your users faster by starting 2FA flows with start_verification and check_verification_code. - Keep a pulse on your spending with get_account_balance so you never hit a zero balance during a peak period. - Manage your entire fleet of virtual numbers in one place using list_rented_numbers and update_number_webhook. ## How It Works The bottom line is you get a unified way to handle global communications through a single chat interface. 1. Connect your Vonage API keys to the Connector. 2. Link your AI client like Claude, Cursor, or Windsurf. 3. Start sending messages and managing numbers through your chat window. ## Frequently Asked Questions **Can the Vonage MCP send WhatsApp messages?** Yes, you can send WhatsApp messages through your AI agent using the Vonage Messages API. This allows you to reach customers on a platform they already use every day. **How do I use Vonage MCP for 2FA?** You can use it to start identity verification by sending a code to a phone number and then checking the code the user provides. It makes securing your user accounts much faster. **Can I check my balance with Vonage MCP?** Yes, your agent can check your real-time credit balance at any time. This helps you stay on top of your spending without needing to log into the Vonage dashboard. **Does Vonage MCP support international SMS?** It does. You can use it to check the specific pricing for any country and then send outbound messages to those regions directly through your chat. **How do I manage my virtual numbers via the Connector?** You can use your agent to list all the virtual numbers rented on your account and update the inbound webhooks for them. It's a much faster way to manage your communication fleet. **Can I update webhooks for my numbers?** Yes, you can update the inbound SMS callback URL for any of your virtual numbers using a simple chat command. This is great for quickly changing where your data is sent. **Can I send WhatsApp messages using this server?** Yes. The `send_whatsapp_message` tool allows you to send outbound WhatsApp messages through the Vonage Messages API. You'll need a verified WhatsApp Business Number configured in your Vonage account as the sender. **How do I implement two-factor authentication (2FA)?** You can use the `start_verification` tool to send an OTP code to a user's phone. Once the user receives the code, use `check_verification_code` with the `request_id` to validate it. Your agent can handle the entire flow through a single conversation. **Can I check how much sending an SMS will cost me?** Absolutely. Use the `get_country_pricing` tool and provide the ISO country code (e.g., 'US' or 'GB'). Your agent will return the outbound SMS pricing for that region, helping you estimate costs before sending.