communication
Plivo CLI for Headless Automation
Use the Plivo CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API token auth
Plivo CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Plivo CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Plivo CLI for Headless Automation
kosmokrator integrations:configure plivo --set auth_id="$PLIVO_AUTH_ID" --set auth_token="$PLIVO_AUTH_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call plivo.plivo_list_messages '{"limit":1,"offset":1,"message_direction":"example_message_direction","message_state":"example_message_state","src":"example_src","dst":"example_dst","start_time":"example_start_time","end_time":"example_end_time"}' --jsonDiscovery Before Execution
Agents and scripts can inspect Plivo docs and schemas before choosing a function.
kosmo integrations:docs plivo --json
kosmo integrations:docs plivo.plivo_list_messages --json
kosmo integrations:schema plivo.plivo_list_messages --json
kosmo integrations:search "Plivo" --json
kosmo integrations:list --jsonUseful Plivo CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
plivo.plivo_list_messages | Read | limit, offset, message_direction, message_state, src, dst, start_time, end_time | List SMS messages from Plivo with optional filters. Supports filtering by direction (inbound/outbound), message state, date range, sender, and recipient. Returns paginated message records. |
plivo.plivo_send_sms | Write | src, dst, text, type, url, log | Send an SMS message via Plivo. Specify a source phone number (must be a Plivo number), one or more destination numbers, and the message text. Returns the message UUID and details. |
plivo.plivo_list_numbers | Read | limit, offset, number_type, service | List phone numbers on your Plivo account. Supports filtering by number type, service, and pagination. |
plivo.plivo_get_number | Read | number | Retrieve details of a specific phone number on your Plivo account by its number (e.g., "+14155552671"). Returns alias, application, service type, and other number properties. |
plivo.plivo_list_calls | Read | limit, offset, call_direction, call_state, from_number, to_number, start_time, end_time | List calls from Plivo with optional filters. Supports filtering by direction (inbound/outbound), call state, date range, and phone numbers. Returns paginated call records. |
plivo.plivo_get_call | Read | call_id | Retrieve detailed information about a specific Plivo call by its call UUID. Returns call details including duration, direction, status, and recording information. |
plivo.plivo_list_applications | Read | limit, offset | List Plivo voice applications on the account. Returns application IDs, names, answer/hangup URLs, and associated number counts. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.