# Twilio MCP

> Twilio MCP lets you manage your entire communications infrastructure—SMS, voice calls, and recordings—through natural conversation. You can send messages, initiate outbound calls with specific instructions, track call activity, audit API keys, and review detailed billing usage without ever leaving your AI client. It puts full telecommunications control directly into the hands of your agent.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** sms-messaging, voice-api, telephony, call-tracking, api-governance, billing-analytics

## Description

You connect this MCP to give your AI agent direct command over your phone system. Instead of logging into a web console or writing custom scripts, you talk to your agent and tell it exactly what you need done with communications. For example, if an emergency alert goes out, the agent can immediately dispatch plain text messages to specific groups or initiate a voice call for real-time updates. You also gain visibility into historical data; you can list recent calls, retrieve detailed metadata on individual texts, or pull all stored audio recordings just by asking. Because this MCP is hosted within Vinkius, you get access to these critical telecom tools alongside thousands of other services through one connection point, making your agent a true operational center.

## Tools

### cancel_active_call
Immediately terminates an active voice call when it needs to be stopped.

### delete_message
Permanently deletes a specific SMS message record, making the content inaccessible.

### get_account_info
Retrieves general information about the master Twilio account status.

### get_message_details
Pulls detailed metadata for a single, specific SMS message.

### get_recording_details
Fetches comprehensive information about a particular call recording using its SID.

### get_usage_records
Retrieves the detailed usage statistics and billing records for the account period.

### list_calls
Lists all recent voice calls that have been associated with the account.

### list_api_keys
Displays a list of all API keys currently configured for the account.

### list_messages
Lists all recent SMS messages, both those sent and those received by the account.

### list_phone_numbers
Shows a list of every incoming phone number that belongs to the account.

### list_call_queues
Lists all call queues that have been configured within the account.

### list_recordings
Displays a list of every stored voice recording available in the system.

### lookup_phone_number
Looks up information about any phone number provided in E.164 format.

### create_voice_call
Initiates a new outbound voice call using specified caller and receiver numbers, following TwiML instructions.

### send_sms
Sends an SMS message to a target number from a specific sender number.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +14155552671 from my main number saying 'Server 3 is down, investigate ASAP'.
```

**Response:** 
```
The SMS has been successfully dispatched. The Message SID is SMxyz123 and the current status is 'queued'. I can check back in a minute to confirm delivery.
```

**Prompt:** 
```
List my recent phone calls and tell me if any failed.
```

**Response:** 
```
I've retrieved 15 recent calls. 14 completed successfully. One call (SID CAabc456) has the status 'failed' to +15551234. Would you like to view the error details?
```

**Prompt:** 
```
Show me our Twilio usage statistics to help understand our bill.
```

**Response:** 
```
Accessing usage records... So far, your heaviest consumption comes from SMS outbound ($45.00 total over 4,500 messages). Voice minutes account for $12.30. Should I break down the voice categories further?
```

## Capabilities

### Manage outbound messaging
Dispatch plain text SMS messages and permanently delete message records.

### Initiate voice communications
Start phone calls, specifying a target number and the instructions (TwiML) for what happens during the call.

### Monitor communication history
List recent calls, retrieve detailed data on specific messages, or pull all stored voice recordings.

### Audit account security and billing
Check current API keys for access control and retrieve detailed usage statistics alongside formal billing records.

## Use Cases

### Investigating an outage
A Site Reliability Engineer asks their agent: 'What happened with our main alerts yesterday?' The agent responds by running list_calls, filtering for failed calls, and then using get_message_details to check if a critical SMS alert was successfully sent. This confirms the failure point instantly.

### Handling missed customer follow-up
A Support Manager asks: 'Show me all texts from Client X this week and any recordings.' The agent uses list_messages to pull the chat history, then runs list_recordings to provide immediate access to voice interactions for review.

### Budget verification
A Founder needs to validate spending against a new marketing campaign. They ask: 'What was our comms spend last week?' The agent uses get_usage_records, providing granular data on both SMS and voice minutes for budget accountability.

### Testing call flow before deployment
An Engineer needs to verify the TwiML logic. Instead of deploying code, they prompt: 'Test an outbound call to +15551234 with this script.' The agent uses create_voice_call, allowing for safe testing and immediate feedback.

## Benefits

- Stop jumping between consoles. You can trigger urgent alerts—like using the send_sms tool for a paging alert or calling create_voice_call to notify staff—all through your agent’s chat interface.
- Audit risk without code. Quickly run list_api_keys and get_account_info to check who has programmatic access, ensuring you catch rogue keys before they cause issues.
- Never lose context on a customer issue. Your agent can pull the full history by using list_recordings or get_message_details, giving you all the necessary information immediately.
- Control costs instantly. By calling get_usage_records, you get your exact spend stats and billing records, helping keep budgets under control without manually downloading spreadsheets.
- Process communications in bulk. You can use list_messages to see every sent or received text, providing a quick overview of recent activity across the entire account.

## How It Works

The bottom line is that your AI client turns complex telecommunications tasks into simple, conversational commands.

1. Subscribe to this MCP in your Vinkius catalog.
2. Enter your Twilio Account SID and Auth Token credentials.
3. Direct your AI agent to perform actions using natural language prompts.

## Frequently Asked Questions

**How do I check my Twilio spending using the Twilio MCP?**
You use get_usage_records. This tool retrieves detailed usage statistics and billing records, allowing you to see exactly where your money is going without needing to access a separate invoicing portal.

**Can I stop an ongoing call with the Twilio MCP?**
Yes, you can immediately terminate it by calling cancel_active_call. This allows you to cut off calls that are stuck or need immediate redirection.

**What is the best way to review old voice recordings using the Twilio MCP?**
You first use list_recordings to see a comprehensive list of all stored audio files. Then, you can request get_recording_details on any specific SID to view its full metadata.

**How does sending an SMS work with the Twilio MCP?**
You use send_sms by providing both a sender number and the target receiver number. The agent executes this command, dispatching the plain text message instantly via the API.

**Do I need to manually update my credentials for the Twilio MCP?**
When setting up, you enter your Account SID and Auth Token into Vinkius. After that initial setup, your AI agent handles the connection automatically until those keys are revoked.