# Plivo — MCP server on mcp.ai
> Connect your Plivo account and use 6 tools for communication straight from your AI agent. Connect with your own API key. Plivo provides programmable voice, messaging, phone number, SIP, verification, and communications APIs.

By: mcp.ai · official
Page: https://mcp.ai/plivo

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_plivo?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/plivo/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/plivo/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/plivo/skill.md
Postman collection (v2.1): https://mcp.ai/plivo/postman.json

## Tools
- plivo_get_account_details() — Return billing, credit, timezone, and account-type details for the connected Plivo account. Use this to inspect account status and configuration before querying communication resources.
- plivo_get_message(message_uuid: string) — Retrieve one existing Plivo message by its message UUID, including delivery, routing, timing, error, and billing details when available.
- plivo_get_usage_summary(cursor?: string, product?: string[], to_date: string, direction?: string, from_date: string, page_size?: integer, error_code?: string, subaccount?: string, country_iso?: string, granularity: string, hangup_cause?: string) — Return one page of Plivo spend and usage grouped by hour, day, month, or year for a required date range, with optional usage filters.
- plivo_list_calls(limit?: integer, cursor?: string, status?: string, end_time?: string, to_number?: string, start_time?: string, subaccount?: string, from_number?: string, hangup_source?: string, call_direction?: string, parent_call_uuid?: string, hangup_cause_code?: string) — Return one page of Plivo call history, optionally filtered by time, direction, status, participants, hangup details, parent call, or subaccount. This does not initiate or modify calls.
- plivo_list_messages(limit?: integer, cursor?: string, end_time?: string, to_number?: string, start_time?: string, subaccount?: string, from_number?: string, message_type?: string, message_state?: string, message_direction?: string) — Return one page of inbound and outbound Plivo message history, optionally filtered by time, direction, state, sender, recipient, type, or subaccount. This reads existing message records and does not s
- plivo_list_owned_numbers(alias?: string, limit?: integer, cursor?: string, services?: string, subaccount?: string, number_type?: string, number_startswith?: string) — Return one page of phone numbers currently owned by the connected Plivo account, optionally filtered by prefix, type, service, alias, or subaccount.

## Example prompts
- "What can I do in Plivo?"
- "Show me a summary of my Plivo account"

## Links
Docs: https://mcp.ai/docs/mcps/plivo
Website: https://mcp.ai/mcps/plivo