A FastMCP (Model Context Protocol) plugin to interact with Plivo's API for sending SMS, making calls, creating applications/endpoints, and retrieving call/message details.
This plugin is compatible with Claude Desktop and allows Claude to interact with telephony workflows programmatically.
- Send SMS via Plivo
- Make Voice Calls with custom answer/hangup/ring URLs
- Create Voice Applications for call routing
- Create SIP Endpoints for VoIP use
- Get Call Detail Records (CDRs)
- Get Message Detail Records (MDRs)
All capabilities are exposed as MCP tools using the fastmcp framework.
Install Python dependencies:
pip install fastmcp plivogit clone https://github.com/your-org/plivo-mcp.git
cd plivo-mcpEdit the Claude Desktop config.json file (refer to Claude Setup Guide):
Steps:
Update config.json for Claude Desktop
Open Claude Desktop.
Go to Settings → Developer Tools.
Click on "Open config.json".
In the opened file, update the configuration as needed.
{
"mcpServers": {
"plivo": {
"command": "python3",
"args": ["/absolute/path/to/plivo_mcp_server.py"],
"env": {
"PLIVO_AUTH_ID": "your_auth_id",
"PLIVO_AUTH_TOKEN": "your_auth_token",
"MY_NUMBER":
72B1
"your_verified_number"
}
}
}
}Then launch Claude Desktop and connect to the Plivo MCP server from Claude's tool menu.
python3 plivo_mcp_server.pyTo get started with Claude Desktop:
- Download the Claude Desktop app from the official site.
- Install and launch the app.
- Open your
config.jsonfile and add the MCP server block as shown above. - In Claude Desktop, open your
config.jsonfile and modify it as shown in step 3 above. - Enable the server, and Claude will auto-discover tools.
- Start chatting and invoke tools like
plivo/send_smsorplivo/make_callusing natural language.
| Tool Name | Description |
|---|---|
send_sms |
Send an SMS using Plivo |
make_call |
Make an outbound voice call |
create_application |
Create a voice app on Plivo |
create_endpoint |
Create a SIP endpoint for VoIP |
get_cdr |
Get details of a past call (CDR) |
get_mdr |
Get details of a past SMS message (MDR) |
Use tool plivo/send_sms with from_number: "+14156667777", to_number: "+14155551234" and text: "Your appointment is confirmed."
Use tool plivo/make_call with from_number: "+14156667777", to_number: "+14155551234", answer_url: "https://example.com/answer.xml", hangup_url: "https://example.com/hangup", ring_url: "https://example.com/ring", machine_detection: "hangup"
Use tool plivo/create_endpoint with username: "agent001", password: "securePass123", alias: "Agent SIP", app_id: "APP_ID_HERE"