Vonage MCP. Manage global messaging, numbers, and verification.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Vonage connects your AI agent to global communications, letting you send SMS, WhatsApp, and Viber messages from one place. It also handles identity verification codes, lets you check account balances, and manages all virtual phone numbers across different countries.
What your AI agents can do
Cancel verification request
Stops an active identity verification request immediately.
Check verification code
Validates if a user's submitted OTP code is correct for an ongoing verification process.
Get account balance
Pulls the current remaining credit balance on your Vonage account.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Vonage MCP: 10 Tools
Use these tools to send messages in multiple formats, manage virtual phone numbers, handle identity verification codes, and monitor billing metrics.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Vonage on Vinkius019d761dcancel verification request
Stops an active identity verification request immediately.
019d761dcheck verification code
Validates if a user's submitted OTP code is correct for an ongoing verification process.
019d761dget account balance
Pulls the current remaining credit balance on your Vonage account.
019d761dget country pricing
Retrieves the cost of sending an outbound SMS message to a specific country code.
019d761dlist rented numbers
Returns a list of every virtual phone number currently assigned to your account.
019d761dsend sms
Sends a standard outbound SMS message using the target E.164 phone number and sender name.
019d761dsend viber message
Dispatches a service message to a recipient via the Viber messaging platform.
019d761dsend whatsapp message
Sends an outbound chat message using the verified WhatsApp Business API credentials.
019d761dstart verification
Initiates a two-factor authentication check by sending a unique OTP code to a target number.
019d761dupdate number webhook
Changes the URL that receives inbound SMS notifications for a specific virtual number.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Vonage, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Vonage. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Tracking communication costs used to be a mess of logins and spreadsheets.
Today, if you need to know how much a campaign will cost in Kenya versus Canada, you have to log into the billing portal, find the rate table, then maybe open a separate document to calculate volume discounts. It's copy-pasting pricing data across three different tabs just to get an estimate.
With this MCP, your agent handles that complexity instantly. You simply ask it for the cost of SMS in Kenya and Canada. You get the real-time quote right in your chat window—no spreadsheets, no logging in, just clean numbers.
Getting the full picture with `get_account_balance`
Before running a marketing blast or sending out 50 status updates, you used to have to manually check the dashboard's credit counter. If you were wrong about the balance and hit zero mid-campaign, everything stopped.
Now, your agent can call `get_account_balance` before starting any work. It gives you a definitive number, letting you plan your message volume with total confidence.
What you can do with this MCP connector
Need to manage global messaging without opening ten separate dashboards? This MCP powers everything related to outbound communication—SMS, WhatsApp, and Viber. Your agent can handle the full customer lifecycle: starting a user's identity verification using an OTP code, sending that code via text, and then letting you check if the submitted code was correct.
If your team manages numbers in multiple countries, you can list every virtual phone number and even update their specific inbound webhooks. It also gives you real-time financial oversight; you pull the current account credit balance or check the exact SMS cost for a new country before running a campaign.
Because this connector handles sensitive credentials across so many channels, all your keys pass through Vinkius's zero-trust proxy, meaning they are used only in transit and never stored on disk. This allows your agent to act as one command center for every message you send.
019d761d-43ec-7129-969a-ac331327d306 
How Vonage MCP Works
- 1 Subscribe to this MCP and input your Vonage API Key and Secret credentials into the platform.
- 2 Your AI client uses the exposed tools—for example, calling
list_rented_numbers—to pull number details or check pricing usingget_country_pricing. - 3 The agent executes the communication flow (like sending a message via
send_whatsapp_message) and returns confirmation data to your chat interface.
The bottom line is that your AI agent becomes your single point of control for all global messaging needs, without you ever logging into the Vonage dashboard.
Who Is Vonage MCP For?
Product Managers and Support Leads who are tired of manually cross-referencing billing dashboards with communication tools. This is for anyone whose job requires reliable, multi-channel customer interaction across borders.
Runs verification codes or sends status updates to a user using the appropriate channel (SMS or WhatsApp) without switching between three different internal dashboards.
Builds campaign logic that first checks get_country_pricing for cost estimates, then uses send_sms to roll out a test message before scaling up the spend.
Needs to track account health by checking the balance using get_account_balance and ensuring that new numbers are correctly configured with an updated webhook via update_number_webhook.
What Changes When You Connect
- Don't guess campaign costs. Use
get_country_pricingto check the exact SMS rate for any country before sending mass messages, saving time and money on planning. - Keep users secure with integrated 2FA flows. Initiate a request using
start_verification, then confirm identity by callingcheck_verification_code—all in one conversation. - Manage your infrastructure without logging into portals. Use
list_rented_numbersand immediately follow up withupdate_number_webhookto point all incoming messages to the right system. - Handle diverse customer needs across channels. Send a status update via
send_whatsapp_messageif they prefer chat, or fall back tosend_smsfor critical alerts. - Maintain financial control at all times. Before any large operation, run
get_account_balanceto confirm you have the necessary credit available.
Real-World Use Cases
User needs immediate account verification.
A user signs up and your agent runs start_verification for their number. After receiving the code, the agent calls check_verification_code, confirming identity and completing onboarding without human intervention.
Launching a new market campaign.
The marketing team needs to send 10,000 messages to Brazil. The agent first uses get_country_pricing for the country code, then estimates total spend and checks the balance with get_account_balance before calling send_sms.
A critical number changes its routing.
The ops team notices a virtual number is misrouted. They use list_rented_numbers to find the ID and then immediately run update_number_webhook, ensuring all future messages land in the right queue.
Handling multi-platform customer support.
A customer asks for help. The agent sends a confirmation link via send_whatsapp_message because that's where they prefer to communicate, keeping the whole interaction within your single chat interface.
The Tradeoffs
Assuming numbers are configured.
Calling a message send tool like send_sms without first checking if the number's webhook is active or pointing to the correct endpoint.
→
Always check and update webhooks first. Use list_rented_numbers to get all numbers, then call update_number_webhook for the specific E.164 format before sending anything.
Forgetting account limits.
Running a large batch of messages based on historical estimates, only to fail mid-way because the API hits a spending limit or runs out of credit.
→
Never send mass communications without first calling get_account_balance and ideally consulting get_country_pricing to verify budget capacity.
Not handling verification failure.
Sending an OTP code using start_verification but having no way to confirm if the user entered it wrong or if the request needed canceling. This leaves the account in limbo.
→
After sending a code, remember both tools: use check_verification_code when the user responds, and keep cancel_verification_request ready if the flow needs to be aborted.
When It Fits, When It Doesn't
Use this MCP if your communication strategy relies on more than one messaging channel (e.g., SMS plus WhatsApp) or requires handling identity verification codes. It's essential for any global service that needs to track costs and manage number lifecycles.
Don't use it if you only ever send simple, non-critical messages through a single, unchanging API endpoint; in that case, a simpler dedicated messaging tool might suffice. However, if your workflow involves numbers changing, verifying users, or tracking spending across borders, this is the definitive choice because of its ability to combine billing data with message sending.
Common Questions About Vonage MCP
How do I check the cost of sending an SMS using get_country_pricing? +
You provide the ISO 3166-1 alpha-2 country code to get_country_pricing. The tool returns the current outbound messaging rate for that specific region.
Can I use send_whatsapp_message if my customer is only reachable by SMS? +
No, you must select the appropriate channel. If WhatsApp fails or isn't available, your agent can fall back to using send_sms for reliable communication.
How does update_number_webhook work with my numbers? +
update_number_webhook lets you change the incoming callback URL for a specific number. This ensures that when Vonage sends an SMS, it hits your intended endpoint, not an old one.
What if I need to stop a verification request? +
If a user starts a verification but then changes their mind, you can immediately use cancel_verification_request to abort the process and prevent further codes from being sent.
How do I use the `check_verification_code` tool after running a verification request? +
You provide the user's entered code directly to check_verification_code. This tool confirms if the One-Time Password (OTP) is correct and completes the identity verification process for your account.
What information does `list_rented_numbers` give me about my Vonage assets? +
It provides a comprehensive list of every virtual phone number tied to your account. This lets you easily audit all numbers, check their status, and confirm their associated capabilities.
What happens if I try to `send_sms` when my balance is low? +
The system first checks your available credit using the get_account_balance tool. If funds are insufficient for the message, the sending attempt fails immediately and prevents any overspending.
How do I send a service message to a user using `send_viber_message`? +
You provide your specific Viber Publisher ID when calling this tool. This allows you to manage communications through the Viber platform, complementing your SMS and WhatsApp efforts.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.