# Plivo MCP for AI Agents AI Agent Connect > Plivo gives your AI agent native telecom powers. It lets your agent send SMS, manage SIP trunks, and audit voice calls autonomously. Instead of manual dashboard navigation, your agent handles the heavy lifting of global communications, from international messaging to live VoIP routing and billing monitoring. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_2zmO73YVp5gYZQWTSATHPeE1ljESa81RFN1S6ajy/ai-agent-connect - **Tags:** sms-api, voice-api, telephony-automation, global-messaging, call-logs ## Description Plivo gives your AI agent the ability to interact with the global telecommunications network directly. Instead of jumping between tabs to manage SMS campaigns or check VoIP status, you can stay inside your AI client and handle everything through chat. You can tell your agent to fire off text messages to specific numbers, check if a voice call is still active, or pull your current account balance to see how much credit you have left. It handles the technical hurdles like E.164 formatting and carrier-specific delivery errors so you don't have to worry about the underlying API logic. You can get started by adding this to your Vinkius catalog, where it joins a wider suite of tools to give your agent more ways to act. It's about moving from asking questions to taking action. Whether you need to audit message failures or clear out stuck sessions, this Connector puts the power of a full telecom suite into your agent's hands. ## Tools ### get_number_details Get details for a specific phone number ### get_recording Get details for a specific recording ### list_recordings List all call recordings ### get_account_info get_account_info pulls your current Plivo account details and status. Use this to check your balance or verify your account is active. ### get_call_details get_call_details retrieves specific metadata for a single voice call. This helps you see exactly how long a call lasted and who it was for. ### get_message_details get_message_details gets the status and content for a specific SMS. You can use this to see if a message actually landed or was rejected. ### list_applications List all Plivo XML applications ### list_calls list_calls shows a list of recent voice call activity. This provides a quick history of who has been calling your numbers lately. ### list_messages list_messages lists both sent and received messages for auditing. Use this to review your communication history or find specific texts. ### list_numbers List all rented phone numbers ### send_sms send_sms sends an SMS message. This allows your agent to dispatch real-time text updates to any destination number. ## Prompt Examples **Prompt:** ``` Check my Plivo balance and let me know if I have enough for 1000 texts. ``` **Response:** ``` I've checked your Plivo account. Here is your current status: - **Account Status:** Active - **Remaining Balance:** $412.55 Based on current rates, 1000 texts will cost approximately $15.00. You have plenty of credit to proceed. ``` **Prompt:** ``` Send an SMS message to 15551234567 from our main 15559876543 local number saying the servers are online. ``` **Response:** ``` Action logged and sent. I've dispatched that SMS from your primary number to the destination. Plivo confirmed the message is in the queue. I'll keep an eye on the status if you need. ``` **Prompt:** ``` Check Plivo network to list all presently active voice phone calls. ``` **Response:** ``` I've checked the network for any active calls. - **Active Calls:** 0 The network is currently clean with no active routing states or phantom loops. ``` ## Capabilities ### Send outbound SMS messages Your agent can dispatch text messages to international and local numbers instantly. ### Initiate and manage live voice calls The agent can start outbound calls and manage active sessions in real time. ### Monitor real-time call status Check the current status and duration of active voice connections. ### Query account billing and balance Retrieve your current funding status and account details automatically. ### List active phone numbers Get a full inventory of every DID and phone number in your account. ### Audit message delivery statuses Identify exactly why a message failed and check carrier delivery logs. ### Terminate hung voice sessions Identify and hang up stuck calls to prevent unnecessary billing. ## Use Cases ### Emergency System Alerts An ops lead asks the agent to text the team if a server goes down. The agent uses send_sms to reach everyone with an immediate update. ### Instant Balance Checks A manager asks, "How much credit is left?" The agent uses get_account_info to report the current balance and status in seconds. ### Phantom Call Cleanup A support lead notices stuck calls and asks the agent to kill them. The agent uses list_calls to find them and terminate_call to end the sessions. ### SMS Payload Testing A developer wants to see if a new text payload works. They ask the agent to send a test text to their phone using send_sms. ## Benefits - Automate real-time alerts by using send_sms to notify your team the moment a system event occurs. - Prevent budget overages by querying get_account_info to monitor your remaining funds automatically. - Stop wasting money on stuck calls by using terminate_call to kill phantom sessions instantly. - Debug carrier issues quickly with list_messages to see exactly why a specific text failed to deliver. - Manage your entire fleet of numbers at once using list_plivo_numbers to see all active DIDs. - Keep your VoIP infrastructure organized by using list_sip_endpoints to see all connected devices. ## How It Works The bottom line is you get a direct bridge to global telecom services through your AI chat interface. 1. Enable the Plivo module in your Vinkius dashboard. 2. Add your Plivo Auth ID and Auth Token to the configuration. 3. Give your agent commands to send texts or manage calls. ## Frequently Asked Questions **Can the Plivo MCP send international texts?** Yes, it handles global destinations and manages the necessary formatting to ensure your messages reach international numbers. **How do I use Plivo MCP to manage my VoIP numbers?** You can list and manage your numbers directly through your AI chat. The agent can show you every DID in your account in seconds. **Can my AI agent stop a call that's stuck?** Yes, your agent can identify active sessions and hang them up immediately to prevent unnecessary charges. **Does Plivo MCP help with SMS delivery issues?** Yes, it can pull failure logs to see exactly why a message didn't go through, helping you identify carrier-specific problems. **Can I check my account balance with Plivo MCP?** Yes, your agent can pull your current funding status and account details whenever you ask. **Is Plivo MCP good for automated alerts?** It is perfect for triggering texts based on your own logic. Your agent can send real-time updates as soon as an event occurs. **How does Plivo MCP handle different phone formats?** It handles the standard formats required by global carriers, so you don't have to worry about E.164 formatting in your prompts. **Can my AI directly check why a specific SMS message failed to send?** Yes. When anomalous delivery states occur, the AI can query `list_messages` identifying problematic entries. Then, executing `get_message` feeding the discrete UUID returns explicit structural insights straight from Plivo’s carrier networks (e.g., 'Destination Not Found', 'Blocked by telecom firewall'). **Is it possible to terminate a live stuck call from my text prompt?** Absolutely. If you detect logic loops keeping Voice trunks active in `list_calls`, instruct the agent to issue the `cancel_call` action. Supplying the precise UUID forces the HTTP architecture to literally send a `DELETE` tear-down protocol, instantly vaporizing the connection physically. **Can the agent interact with my billing limits to warn me?** Correct. Plivo natively exposes account architecture. Prompting the system to fetch `get_account` pulls cash balances, available capacity boundaries, and current currency mapping logic. It allows your Agent to perform autonomous diagnostics warning you natively before critical telecom endpoints shutdown due to zero-balance errors. **Can my AI automatically find the details of a specific message by its UUID?** Yes! Use the `get_message` tool with the Message UUID. Your agent will respond with complete metadata, including delivery status, timestamps, and cost in seconds. **How do I find my Plivo Auth ID and Auth Token?** Log in to your [**Plivo Console Dashboard**](https://console.plivo.com/dashboard/), and you will find your unique Auth ID and Auth Token displayed prominently on the main page. **Does this work for international messaging?** Absolutely. Plivo supports global SMS and Voice services. As long as your account has the required credits and permissions, the AI can trigger communications to any supported destination.