# Vonage MCP for AI Agents AI Agent Connect > Vonage MCP lets you manage your cloud communications through an AI client. Send SMS, check account balances, audit phone numbers, and pull real-time pricing for global messaging and voice services. It turns complex telecom infrastructure into a conversational interface, letting you manage your entire communication stack without ever touching a technical dashboard. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_fN8FVPeAFxRRjrLps1QqBHJiHQGhbMw2QLDMEaVM/ai-agent-connect - **Tags:** cloud-communications, messaging-api, voice-api, telecom-infrastructure, account-management ## Description This Connector lets you treat your entire telecom stack like a conversation. Imagine you are managing a global communication setup and you need to know if an SMS actually landed, how much money you have left in your account, or which phone numbers are currently active. Instead of jumping between different dashboards, you just ask your AI client. You can check if a message went through, see your current spend, or find out what it costs to send a text in a new country without opening a single browser tab. If you need to scale up, you can ask to find available mobile numbers in a specific region and get the details back instantly. It handles the heavy lifting of navigating the infrastructure so you can focus on actually talking to your customers. You will find it is a lot easier to keep your communication data organized when your agent is doing the auditing for you. It is one of the many tools available in the Vinkius catalog that makes managing high-volume messaging feel like a normal chat. You can pull conversation threads or voice call logs to keep your records updated without manual data entry. It turns a technical hurdle into a simple request. It allows you to maintain a steady flow of communication while keeping your backend data perfectly in sync. ## Tools ### list_conversations Get a list of your most recent conversation threads. ### get_balance Check your current account balance to see how much credit you have left. ### get_pricing Get the exact cost for messaging or voice in any specific country. ### list_account_secrets View the secrets and keys associated with your account. ### list_applications See a list of all applications registered to your account. ### list_voice_calls Retrieve a list of your most recent voice calls. ### send_sms Send an SMS message to a recipient instantly. ### list_phone_numbers Retrieve a list of every phone number currently active on your account. ### list_search_numbers Search for available phone numbers in different countries and types. ### list_users See all users currently listed in your account. ## Prompt Examples **Prompt:** ``` How much credit is left in my Vonage account? ``` **Response:** ``` I've checked your account details. You currently have **€15.42** available. Would you like me to check the pricing for your next message or list your active numbers? ``` **Prompt:** ``` Can you find me some available mobile numbers in the UK? ``` **Response:** ``` I found several available mobile numbers in the UK (GB). Here are a few examples: * 447700900123 * 447700900456 I can pull the full metadata for any of these if you need more details. ``` **Prompt:** ``` Send a text to +1234567890 saying 'Your order is on the way'. ``` **Response:** ``` Done! I've sent that SMS to +1234567890. **Status:** Sent successfully. Is there anything else you need help with? ``` ## Capabilities ### Send messages Send an SMS message to any recipient immediately. ### Check balance See your current account balance to see how much credit you have left. ### List numbers Retrieve a list of every phone number currently active on your account. ### Search numbers Find available phone numbers in different countries and types. ### Get pricing Get the exact cost for messaging or voice in any specific country. ### Audit calls Review your recent voice call history and conversation threads. ## Use Cases ### Checking real-time budget An operations manager asks the agent for the current spend. The agent uses get_balance to provide an instant update. ### Verifying message delivery A customer success lead asks if a notification was sent. The agent uses send_sms and checks the status in one go. ### International pricing research A business owner wants to know the cost of texting in the UK. The agent uses get_pricing to provide a breakdown. ### Expanding global reach A developer needs to find a mobile number in France. The agent uses list_search_numbers to find options instantly. ## Benefits - Stop tab-switching by using send_sms and get_balance directly in your chat interface. - Get instant cost clarity with get_pricing to plan global communication budgets accurately. - Audit your infrastructure faster by using list_phone_numbers to see all active assets at once. - Quickly scale your reach by using list_search_numbers to find available numbers in new regions. - Keep a clean history of interactions by pulling data with list_conversations and list_voice_calls. ## How It Works The bottom line is you can manage global communications through a simple chat interface. 1. Subscribe to the Vonage MCP on Vinkius 2. Enter your API Key and Secret in your client settings 3. Ask your AI client to manage your communications ## Frequently Asked Questions **Can I use the Vonage MCP to send messages to customers?** Yes, you can use your AI client to send SMS messages instantly. It handles the communication for you so you don't have to leave your workspace. **How does the Vonage MCP help with my communication budget?** It allows you to check your real-time account balance and pull live pricing for different countries, making it much easier to track and manage your spending. **Can I find new phone numbers using the Vonage MCP?** Absolutely. You can ask your agent to search for available numbers in specific regions and types, and it will return the results for you immediately. **Does the Vonage MCP work for international SMS pricing?** Yes, it can pull real-time pricing for messaging and voice services across different countries, which helps with planning global communication costs. **Can I see my recent call history with the Vonage MCP?** Yes, you can ask your AI client to list your recent voice calls and conversation threads to keep your records organized and up to date. **How do I connect the Vonage MCP to my AI client?** You just need to subscribe to the Connector, provide your API Key and Secret in your client settings, and you can start managing your communications via chat. **How do I find my Vonage API Key and Secret?** Log in to your [**Vonage API Dashboard**](https://dashboard.nexmo.com/), and you will find your API Key and API Secret right at the top of the page. Copy and paste them below. **Can the agent check my available credit balance?** Yes. Use the `get_balance` tool. Your agent will retrieve your current account balance in Euros (the default currency for Vonage accounts). **Is it possible to search for new phone numbers via the agent?** Yes. The `list_search_numbers` tool allows your agent to query available phone numbers in a specific country, helping you identify new assets for your communication project.