Vonage MCP. Manage all messaging and number ops from one API.

Vonage MCP Server lets your agent handle global comms—SMS, WhatsApp Business, and Viber—all from one API connection. You'll never need to jump between dashboards again. It gives your AI client the full toolkit for messaging, handling user verification flows (like OTP), and keeping an eye on account costs and number status.

Sending Messages Across Channels

Your agent can send outbound texts using send_sms, requiring just a sender name and the E.164 formatted target number. For WhatsApp, you use send_whatsapp_message; remember that tool needs a verified Business Number as the sender. If you're talking to someone on Viber, you dispatch a service message via send_viber_message after providing your unique Publisher ID.

Managing Identity Verification (2FA)

When you need to secure an account or verify a user, this server runs the whole identity check directly in your chat flow. You initiate the process with start_verification, which sends an OTP code to a target number using your brand name for context. When the user submits that code, your agent verifies it using check_verification_code against the expected account code.

If the request gets stuck or needs to be stopped before completion, you run cancel_verification_request to halt any pending identity verification attempt.

Checking Accounts and Costs

Before sending anything out, you always want to know if you can afford it. You check your current Vonage API credit balance with get_account_balance. If you're just estimating costs for a new market, you get the out-of-band SMS cost for any country code using get_country_pricing, which accepts the ISO 3166-1 alpha-2 format.

Handling Virtual Phone Numbers

Your agent keeps track of your assets by generating a complete list of all virtual numbers registered to your Vonage account via list_rented_numbers. If an incoming number changes its callback URL, you can update it immediately using update_number_webhook, which requires the E.164 format input for that specific virtual number.

Here's the rundown on what your agent does with these tools:

• Sending: Your client doesn't just send a message; it determines the best path—SMS, WhatsApp Business, or Viber—and invokes the correct tool call to dispatch that text.
• Verification Flow: It manages the entire sequence: sending the initial OTP via start_verification, waiting for user input, validating that code with check_verification_code, and having the option to clean up a failed attempt using cancel_verification_request.
• Status Checks: You check operational status by calling get_account_balance to see how much credit you've got left. You also get real-time cost data for specific countries through get_country_pricing, so you know the price point before committing to a send.
• Number Control: The agent provides full visibility into your phone assets, listing every number available via list_rented_numbers. It can then proactively keep your infrastructure updated by changing incoming webhook URLs with update_number_webhook for any of those listed numbers.