# Vonage MCP > The Vonage MCP lets your AI agent manage all aspects of your cloud communications directly from conversation. Send SMS messages, check account balances instantly, and audit past conversations without logging into a separate dashboard. Use it to search for available phone numbers globally or track voice call history—all hands-free. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** cloud-communications, messaging-api, voice-api, telecom-infrastructure, account-management ## Description Managing a global communication system is usually a mess of dashboards, API calls, and toggling between different provider portals. This MCP changes that. It gives your AI agent the power to handle every Vonage task through natural language conversation. You'll never need to manually check if you have enough funds or spend time sifting through old logs again. Your agent can instantly tell you your current account balance, send a confirmation text, and even search for new phone numbers in a specific country—all without you ever touching the Vonage website itself. Because this MCP is hosted on Vinkius, you just connect it once from any compatible client like Claude or Cursor, and your entire communication infrastructure is suddenly accessible via conversation. This makes reliable, data-driven messaging a simple chat query. ## Tools ### get_balance Retrieves the current financial balance for your Vonage account. ### get_pricing Looks up the cost of messaging and voice services for a specific country. ### list_account_secrets Displays necessary administrative account secrets for your Vonage setup. ### list_applications Shows all active applications configured within your Vonage environment. ### list_conversations Retrieves a list of your recent text message conversations for auditing purposes. ### list_phone_numbers Lists all active and associated phone numbers registered to your Vonage profile. ### list_search_numbers Searches for and lists available, unused phone numbers based on country criteria. ### list_users Retrieves a list of all user accounts configured under the Vonage system. ### list_voice_calls Provides a history and detailed list of your recent voice calls. ### send_sms Executes sending an SMS message to a specified recipient number. ## Prompt Examples **Prompt:** ``` List all my Vonage phone numbers. ``` **Response:** ``` I've retrieved your phone numbers. You have 2 active numbers: '1234567890' and '0987654321'. Both are currently active and ready for use. ``` **Prompt:** ``` Check my Vonage account balance. ``` **Response:** ``` I've retrieved your balance. You currently have €15.42 available in your account. I can also check the pricing for your next message if you like. ``` **Prompt:** ``` Search for available mobile numbers in the UK. ``` **Response:** ``` I've found 5 available mobile numbers in the UK (GB). Examples include '447700900123' and '447700900456'. Would you like the full metadata for any of them? ``` ## Capabilities ### Send text messages You can instruct your agent to send an SMS message immediately. ### Check account financial status The MCP retrieves the current Vonage account balance and details about associated secrets. ### Audit communication history You can list past text conversations, recent voice calls, or all phone numbers linked to your profile for review. ### Search for new numbers The agent searches and lists available mobile or fixed phone numbers in specific countries, helping you expand coverage. ## Use Cases ### The emergency alert system needs a status check. An operations manager asks their agent: 'What is our current Vonage account balance?' The agent uses `get_balance` to respond immediately, confirming they have enough funds for the planned alerts without requiring the manager to log into the financial portal. ### A customer needs a service verification. A support rep asks: 'Did we send that password reset text yesterday?' The agent uses `list_conversations` and `list_phone_numbers` to pull up both the conversation thread and confirmation of which number was used, resolving the issue instantly. ### Launching into a new market. A business owner asks: 'Find me five available mobile numbers in Canada.' The agent uses `list_search_numbers` to return several options and their metadata, allowing the business owner to select numbers for expansion without manual research. ### Post-incident review of a call. A QA specialist asks: 'Show me all calls made last week.' The agent uses `list_voice_calls` and `list_users` to provide a comprehensive audit trail, speeding up the root cause analysis process. ## Benefits - Send texts instantly. You can use the `send_sms` tool to send a message directly from your workflow, eliminating the need to open the Vonage messaging dashboard. - Know your costs immediately. Check service pricing for any country using `get_pricing`, allowing you to factor communication expenses into planning without manual lookups. - Audit everything at once. Use `list_conversations` or `list_voice_calls` to pull detailed records of past activity, making compliance checks immediate and effortless. - Never lose a number. The MCP lets you `list_phone_numbers`, giving you an instant inventory check on all numbers tied to your account for quick verification. - Expand reach painlessly. Need new coverage? Use the `list_search_numbers` tool to find available phone lines in target countries, greatly speeding up expansion planning. ## How It Works The bottom line is that you treat complex telecom management as simple conversation, getting actionable data back instantly. 1. Subscribe to this MCP on Vinkius and provide your Vonage API Key and Secret. 2. Your AI client accesses the credentials via Vinkius and connects it to your conversational workflow. 3. You simply ask your agent a question, like 'What's my balance?' or 'Send an SMS to 123...', and the MCP executes the action. ## Frequently Asked Questions **How do I send a text message using the Vonage MCP?** You use the `send_sms` tool by simply telling your agent who you want to send the text to. You provide the recipient number and the message body in one prompt, and it sends the SMS. **What does list_phone_numbers do with Vonage?** The `list_phone_numbers` tool pulls a comprehensive inventory of every phone line currently associated with your account. This helps you verify which numbers are active and ready for use. **Can I check my billing costs using the Vonage MCP?** Yes, you can use `get_pricing`. You just need to tell the agent what country's rates you want to know about, and it retrieves real-time cost data. **Is list_conversations the same as list_voice_calls?** No. `list_conversations` handles your text message history, while `list_voice_calls` provides a record and detail of all phone calls made or received. **What if I need more numbers? Can Vonage MCP help?** The agent can search for new options using the `list_search_numbers` tool. You provide the country, and it returns a list of available mobile or fixed lines.