# Twilio MCP for AI Agents AI Agent Connect > Twilio MCP lets you manage your entire telecommunications setup through your AI client. Send SMS messages, initiate outbound calls, listen to recordings, and track your billing and API usage without leaving your workspace. It turns your agent into a programmable communication hub for real-time messaging and voice. You can handle everything from sending a quick alert to auditing your API keys in one place. ## Overview - **Category:** talk-to-me - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_FCKz8x9WdpvG6gLpwPVeUQLzosRFa0iDlzdJYpC0/ai-agent-connect - **Tags:** sms-messaging, voice-api, telephony, call-tracking, api-governance, billing-analytics ## Description You're tired of jumping between the Twilio Console and your own dashboard to see if a call went through or to check how much you spent this month. This Connector changes that by bringing your telephony infrastructure directly into your AI client. Instead of hunting for specific IDs or navigating nested menus, you can just tell your agent to send a text, look up a phone number, or pull a list of recent recordings. It handles the heavy lifting of interacting with the Twilio API so you can stay in your flow. Whether you're debugging a stuck call, checking your spend, or grabbing a call recording for a support ticket, everything happens through a single conversation. You'll find it's a lot faster to just ask your agent to list your recent messages than it is to refresh a web page and filter through a list of data. By connecting your Twilio account to Vinkius, you get a direct line to your communication tools, making your agent a functional hub for your team's phone and SMS needs. You don't have to worry about the underlying API logic because the agent handles the requests for you. It's about getting the information you need or taking the action you want without the friction of a traditional dashboard. ## Tools ### get_recording_details Fetches info for a specific recording using its SID. This helps you find the exact metadata for a saved voice file. ### get_usage_records Pulls your account's billing and usage statistics. Use this to see exactly how much you're spending on different services. ### list_phone_numbers Lists every phone number owned by your account. Use this to see your full inventory of active numbers. ### list_call_queues Lists all call queues currently configured. This helps you see how your inbound traffic is being routed. ### list_recordings Lists every voice recording stored in your account. Use this to browse your entire library of saved audio files. ### send_sms Sends a text message to a target number. This is the primary tool for dispatching notifications or alerts. ### cancel_active_call Ends a live voice call immediately. Use this when a call needs to be terminated for safety or technical reasons. ### get_account_info Pulls the current status of your master Twilio account. Check this to ensure your account is active and healthy. ### get_message_details Grabs the specific metadata for a single SMS. Use this to see delivery status or segment counts for a specific text. ### lookup_phone_number Finds information about a specific phone number in E.164 format. Use this to see if a number is valid or has specific info. ### create_voice_call Starts an outbound call using a TwiML URL. Use this to trigger automated voice instructions for a recipient. ### delete_message Permanently removes an SMS record from your history. This is useful for cleaning up sensitive data or accidental sends. ### list_calls Shows a list of your most recent voice calls. This is the quickest way to see your recent call history. ### list_api_keys Lists all the keys configured for your account. Use this to audit who has access to your Twilio infrastructure. ### list_messages Shows the recent SMS messages sent and received. This gives you a quick overview of your recent text traffic. ## Prompt Examples **Prompt:** ``` Send a text to +14155552671 saying 'The maintenance window is now open'. ``` **Response:** ``` I've sent that SMS. It's currently in the queue with ID **SMxyz123**. I'll let you know if the status changes to 'delivered'. ``` **Prompt:** ``` What was our total spend on voice calls so far this month? ``` **Response:** ``` Your voice minutes have cost a total of **$12.30** so far this month. Most of that came from your outbound automated notifications. Would you like a full breakdown of the usage records? ``` **Prompt:** ``` Can you find the last recording from a customer call and give me the link? ``` **Response:** ``` I found your most recent recording (**RE987**). You can listen to it here: [Link] The call lasted 4 minutes and 12 seconds. ``` ## Capabilities ### Send SMS messages Dispatch plain text messages to any phone number instantly. ### Start outbound calls Initiate voice calls using TwiML instructions with a single command. ### Fetch call recordings Get direct play URLs for your stored voice recordings. ### Track billing usage See your account's spend and usage records in real-time. ### Audit API keys List and manage the keys used for your programmatic access. ### Cancel active calls Terminate ongoing voice calls immediately when they're no longer needed. ## Use Cases ### Emergency Alerting A DevOps engineer asks the agent to send an SMS alert when a server goes down. The agent uses send_sms to notify the team immediately. ### Support Review A manager needs to hear a customer's complaint. They ask the agent to find the latest recording, and the agent uses list_recordings to provide a play URL. ### Budget Check A founder asks 'How much did we spend on SMS this week?' and the agent uses get_usage_records to provide a clear breakdown. ### Call Management An engineer sees a call stuck in a loop. They tell the agent to 'cancel the active call,' and the agent uses cancel_active_call to stop it. ## Benefits - Stop switching tabs by managing SMS and voice calls directly in your AI client using send_sms and create_voice_call. - Audit your security posture quickly by listing and checking all active credentials with list_api_keys. - Keep your budget in check by pulling real-time spending data with get_usage_records instead of hunting through billing pages. - Resolve customer issues faster by grabbing specific call recordings or message metadata using list_recordings and get_message_details. - Manage your telephony inventory instantly by listing your numbers and call queues with list_phone_numbers and list_call_queues. - Take immediate action on live issues by terminating hung calls with cancel_active_call without needing to log into a dashboard. ## How It Works The bottom line is you get a conversational interface for your entire Twilio setup. 1. Subscribe to the Twilio MCP on Vinkius. 2. Enter your Twilio Account SID and Auth Token. 3. Command your AI client to send texts, list calls, or pull recordings. ## Frequently Asked Questions **How does the Twilio MCP help my team?** It connects your Twilio account to your AI client so you can send texts and manage calls using natural language instead of clicking through a dashboard. **Can I use the Twilio MCP to send automated alerts?** Yes, you can tell your agent to send an SMS whenever an event occurs, making it a great tool for automated notifications. **How do I see my Twilio spending with this?** Just ask your agent to show your usage records. It will pull your latest billing stats and tell you exactly what you're spending on. **Can I stop a call that's currently happening?** Yes, your agent can use the cancel tool to immediately terminate any active voice call in your account. **Does the Twilio MCP support voice recordings?** It can list all your recordings and provide direct play URLs so you can listen to them without leaving your chat. **Is it safe to connect my Twilio account?** You provide your SID and Auth Token to the Connector, which your AI client uses to perform actions on your behalf securely. **Can I manage multiple phone numbers?** Yes, the Connector can list all numbers owned by your account, making it easy to see your entire inventory at once. **Can my AI agent trigger an incident alert SMS to the on-call engineer?** Absolutely. You can provide your Twilio phone number, the destination E.164 number, and the alert body text. The agent will hit the Twilio API instantly, dispatch the SMS, and return the Message SID along with delivery status. **How can I stop a rogue voice call stuck in a loop?** Ask your agent to list active or recent voice calls and find the offending Call SID. Then instruct the AI to cancel the active call by its ID. The agent updates its status to 'canceled', dropping the connection right away. **Can it check how much my company has spent so far this month?** Yes. Ask the agent to pull your account's usage records. It interfaces with the Twilio billing records and can display breakdowns of amounts sent, call durations, and costs incurred, giving you full transparency without opening the dashboard.