communication
ClickSend CLI for Headless Automation
Use the ClickSend CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
10 functions 6 read 4 write API key auth
ClickSend 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 ClickSend CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# ClickSend CLI for Headless Automation
kosmokrator integrations:configure clicksend --set username="$CLICKSEND_USERNAME" --set api_key="$CLICKSEND_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call clicksend.clicksend_get_account_balance '{}' --json Discovery Before Execution
Agents and scripts can inspect ClickSend docs and schemas before choosing a function.
kosmo integrations:docs clicksend --json
kosmo integrations:docs clicksend.clicksend_get_account_balance --json
kosmo integrations:schema clicksend.clicksend_get_account_balance --json
kosmo integrations:search "ClickSend" --json
kosmo integrations:list --json Useful ClickSend CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
clicksend.clicksend_get_account_balance | Read | none | Get the current ClickSend account balance. |
clicksend.clicksend_get_email_history | Read | limit, page | Get email message history from ClickSend with pagination. |
clicksend.clicksend_get_sms_history | Read | date_from, date_to, limit, page | Get SMS message history from ClickSend. Supports date range filtering and pagination. |
clicksend.clicksend_get_sms_price | Read | messages | Get pricing for SMS messages before sending. Uses the same message format as send SMS but returns cost estimates only. |
clicksend.clicksend_get_voice_history | Read | limit, page | Get voice message history from ClickSend with pagination. |
clicksend.clicksend_list_contact_lists | Read | limit, page | List all contact lists from ClickSend with pagination. |
clicksend.clicksend_send_email | Write | to, subject, body, from_email_address, from_name | Send an email message via ClickSend. Requires recipient, subject, and body. |
clicksend.clicksend_send_post_letter | Write | file_url, template_id, recipients, duplex | Send a post letter via ClickSend. Provide a file URL or template ID with recipient details. |
clicksend.clicksend_send_sms | Write | messages | Send one or more SMS messages via ClickSend. Each message requires a "to" phone number and "body" text. |
clicksend.clicksend_send_voice | Write | messages | Send one or more voice messages via ClickSend. Each message requires a "to" phone number and "body" text. |
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.