# Plivo MCP

> Plivo MCP lets your AI agent manage all aspects of cloud communications. Send SMS messages and make calls instantly, or audit usage by listing recent voice calls and retrieving detailed message history. It also helps you keep track of associated phone numbers and check pricing for various countries.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cloud-communications, sms-api, voice-api, telecom, call-logs, message-delivery

## Description

Your AI client can handle complex telecommunications tasks using this MCP. Instead of logging into a technical console, your agent acts like an instant telecom operator, giving you control over messaging and voice services through natural conversation. You can ask it to list all your connected phone numbers or retrieve the status of a specific message delivery. Need to check usage? Your agent lists recent calls and retrieves call logs with details about duration and status. It even pulls detailed pricing information for different countries so you know exactly what you're spending. When you connect this MCP via Vinkius, your AI client gains access to robust communication intelligence, letting you manage everything from simple message sending to complex operational auditing.

## Tools

### get_account
Retrieves the core details for your Plivo account.

### get_call
Pulls specific data points for a single, chosen call.

### get_message
Retrieves detailed information about one specific text message.

### list_applications
Shows you all the communication applications currently set up in your account.

### list_calls
List recent voice calls

### list_messages
List recent SMS messages

### list_phone_numbers
List Plivo phone numbers

### list_pricing
Get pricing for a country

### make_call
Start an outbound call

### send_sms
Send an SMS message

## Prompt Examples

**Prompt:** 
```
List all my Plivo phone numbers.
```

**Response:** 
```
I've retrieved your phone numbers. You have 2 active numbers: '+1 234 567 890' and '+44 987 654 321'. Both are active and configured for voice and SMS.
```

**Prompt:** 
```
Send SMS 'Your appointment is confirmed' to +15550123.
```

**Response:** 
```
Message sent! I've successfully delivered your confirmation to +15550123 using your Plivo number. The message UUID is xxxxxxxx.
```

**Prompt:** 
```
What is the SMS pricing for Brazil?
```

**Response:** 
```
I've retrieved the pricing for Brazil (BR). Outbound SMS is $0.05 per message, and inbound is free for mobile numbers. Would you like the voice rates as well?
```

## Capabilities

### Sending messages
Your agent sends SMS texts and retrieves the full status and history of those messages.

### Auditing calls
You list all recent voice calls and get metadata for each, including how long they lasted and their final status.

### Checking phone numbers
The MCP lists and tracks every phone number connected to your account.

### Retrieving pricing data
Your agent retrieves specific billing details for messaging and voice services across different countries.

### Initiating calls
You start an outbound phone call directly through your AI client.

## Use Cases

### Verifying Campaign Delivery
A marketing manager needs to confirm if 50 promotional texts went out and were successfully delivered. They ask their agent to list recent SMS messages, which pulls the status for each one, proving delivery success without manual data export.

### Debugging a Voice Issue
A support engineer notices a customer complaint about a dropped call. The agent is asked to get details for a specific call using its ID, which immediately reveals the call's metadata and status, solving the issue quickly.

### Onboarding New Regions
A business owner expands into Mexico and needs pricing data. They prompt the agent to list pricing for a country, instantly getting cost insights for both messaging and voice services before committing resources.

### Security Audit Prep
An operations manager must report on all active communication channels. The agent lists configured Plivo applications, providing an immediate inventory of the logic governing your outgoing communications.

## Benefits

- Instant status updates on messages. Instead of checking a complicated dashboard, you ask your agent to list recent SMS messages or get details for a specific message, knowing its delivery status immediately.
- Deep call auditing capability. You can list all recent voice calls and pull metadata like duration and status with one simple command, making compliance checks fast and painless.
- Never lose track of numbers again. The MCP lists every phone number associated with your account, letting you monitor them from a central place without digging through settings menus.
- Cost transparency. Need to know the cost? Your agent retrieves detailed pricing information for messaging and voice services across various countries, helping you budget accurately.
- Automation power. You can trigger actions like sending an SMS or making a call directly via your AI client, removing manual steps from your communication process.

## How It Works

The bottom line is you get full control of your cloud communications without ever touching a technical dashboard.

1. Subscribe to this MCP and provide your Plivo Auth ID and Auth Token.
2. Connect it to your preferred agent, like Claude or Cursor.
3. Ask your agent natural language questions—for example, 'list my phone numbers' or 'send an SMS to X'.

## Frequently Asked Questions

**How do I check the status of a single SMS using Plivo MCP?**
You use get_message. Simply provide the specific message ID, and the agent retrieves detailed information on that message's current delivery status.

**Does Plivo MCP help me make outgoing calls?**
Yes, you can start an outbound call directly using make_call. Your agent initiates the connection through your AI client for immediate communication.

**What types of data can I retrieve with list_calls in Plivo MCP?**
list_calls provides a summary of recent voice calls, including critical metadata like the call's duration and its final status.

**Can I check pricing for multiple countries using Plivo MCP?**
Yes, you use list_pricing. You just need to specify the country code or region to get detailed cost breakdowns for messaging and voice services.

**Is this MCP only for SMS messages?**
No. While it handles texting using send_sms and list_messages, it also manages full voice communication features like making calls and auditing call logs.