# Plivo MCP

> Plivo MCP gives your AI client native access to a full global telecom network. It lets you send real SMS messages, manage VoIP calls across E.164 formats, and pull specific billing data directly from Plivo's console. Stop relying on visual dashboards; let your agent handle live communications and deep auditing.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** voice-api, sip-trunking, sms-gateway, telecom-infrastructure, e164-formatting, real-time-communication

## Description

This MCP connects your AI client straight into the global telecommunications infrastructure via Plivo. Instead of logging into a web portal or building complex API calls, you simply tell your agent what needs to happen—whether that's sending an urgent SMS notification or tracing an active call path. Your agent handles the complexity of bridging code into live telecom operations. You can ask it to initiate outbound voice calls, check account billing limits, and audit past communication logs for specific failure codes. If you manage critical communications flows, connecting Plivo through Vinkius’s catalog means your AI client has immediate access to advanced voice and messaging capabilities without writing any boilerplate code or binding rules.

## Tools

### terminate_call
Ends an active phone call immediately.

### get_account_info
Fetches the current billing and account details for your Plivo setup.

### get_call_details
Retrieves detailed information about a specific, recorded voice call.

### get_message_details
Pulls granular details regarding any single sent or received message.

### list_calls
Lists a history of recent voice calls made through the service.

### list_sip_endpoints
Retrieves a list of all configured SIP endpoints for routing purposes.

### list_messages
Gets a comprehensive list of both sent and received text messages.

### list_plivo_numbers
Lists all phone numbers registered and available in your Plivo account.

### make_voice_call
Starts a new outbound voice call to a specified number.

### send_sms
Sends an SMS text message from your account's designated source number.

## Prompt Examples

**Prompt:** 
```
Check Plivo account status and let me know my remaining wallet balance.
```

**Response:** 
```
Retrieval confirmed via `get_account`. Primary Plivo account is active securely. Current remaining balance mapped to `$412.55`. Would you like me to ping the `list_calls` node to verify active expenses burning constraints right now?
```

**Prompt:** 
```
Send an SMS message to `15551234567` from our main `15559876543` local number saying the servers are online.
```

**Response:** 
```
Action logged and sent. Executed the mutation `send_sms` seamlessly passing source E.164 and target destinations simultaneously. Plivo acknowledged payload receipt queue mapping it successfully holding object UUID: `a7d-22r9`. I will monitor the background if required.
```

**Prompt:** 
```
Check Plivo network to list all presently active voice phone calls.
```

**Response:** 
```
Query deployed against the active telecom trunk node (`list_calls`). Result: Empty array bounding currently parsed instances. The network endpoints are clean, reporting identically 0 concurrent routing states or phantom SIP loops tied to your active parameters.
```

## Capabilities

### Dispatch SMS messages
Your agent sends text messages to specific international phone numbers using a designated source number.

### Manage active voice calls
You can initiate, check details on, or terminate live outgoing and incoming phone calls.

### Audit message history
The system retrieves detailed logs of sent and received messages, including why specific transmissions failed.

### Review account capacity
You can check the current billing status or list all available phone numbers attached to your Plivo account.

## Use Cases

### Incident Response Alerting
A backend architect needs to alert admins about a service outage. Instead of writing code, they ask their agent to send an SMS using `send_sms` from the main number to all key personnel numbers.

### Call Quality Assurance
The telecom ops specialist suspects phantom calls are draining resources. They run `list_calls`, identify stuck sessions, and tell their agent to execute `terminate_call` on the specific IDs found.

### Pre-Deployment Testing
A developer needs to confirm an integration works before launch. They instruct the agent to make a test call using `make_voice_call` and then check the logs with `get_call_details` for successful connection metrics.

### Billing Reconciliation
An accountant needs proof of services rendered last month. They ask their agent to query both `list_messages` and `get_message_details` across a date range to pull verifiable records.

## Benefits

- You instantly manage complex communications without writing boilerplate. Need to send an SMS? Just prompt your agent; it handles the `send_sms` payload using E.164 formatting automatically.
- Tackle live call management from chat. If a connection gets stuck, you can use `list_calls` and then sweep through any phantom connections with `terminate_call` to clean up resources.
- Deep auditing is now conversational. Instead of digging through dashboards, ask your agent to query the `get_message_details` for specific failure reasons or check `list_messages` for compliance records.
- Verify network readiness instantly. You can use `list_plivo_numbers` to confirm which phone numbers are active and available before running a new campaign.
- Get immediate status checks. Use `get_account_info` to pull your current billing balance or check if you have enough funds remaining for the next operation.

## How It Works

The bottom line is you tell your agent what communication task needs doing, and it executes the required telecom operation instantly through a conversational prompt.

1. Enable the Plivo integration module within Vinkius and provide your Auth ID and Auth Token.
2. Your AI client uses these credentials to establish a direct connection to the Plivo API endpoints.
3. You prompt your agent in natural language, directing it to perform specific telecom actions like checking balances or sending messages.

## Frequently Asked Questions

**How do I check my Plivo account balance using the Plivo MCP?**
Use `get_account_info`. This tool quickly fetches your current billing status and available funds, letting you know if you can afford to run a campaign before you start.

**Can I use the Plivo MCP to send SMS messages from multiple numbers?**
Yes. You first run `list_plivo_numbers` to see all registered sources, and then instruct your agent to execute the `send_sms` tool using a specific number as the source.

**What is the difference between listing calls and getting call details with Plivo MCP?**
Running `list_calls` gives you a summary of recent activity, showing who called whom. Use `get_call_details` when you need the deep dive—the full transcript or metadata for one specific call.

**Does Plivo MCP help me stop stuck calls?**
Absolutely. If a call drops and gets flagged as active, use `list_calls` to find the ID, then tell your agent to run `terminate_call` to clear it from the system.

**Can I audit message failures with Plivo MCP?**
Yes. You can list all messages via `list_messages`, and then use `get_message_details` on any specific ID to pull the exact reason a carrier rejected the frame.