communication
BlandAI CLI for Headless Automation
Use the BlandAI CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
5 functions 4 read 1 write API key auth
BlandAI 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 BlandAI CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# BlandAI CLI for Headless Automation
kosmokrator integrations:configure blandai --set api_key="$BLANDAI_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call blandai.blandai_make_call '{"phone_number":"example_phone_number","task":"example_task","voice":"example_voice","wait_for_greeting":true,"record":true,"max_duration":1}' --json Discovery Before Execution
Agents and scripts can inspect BlandAI docs and schemas before choosing a function.
kosmo integrations:docs blandai --json
kosmo integrations:docs blandai.blandai_make_call --json
kosmo integrations:schema blandai.blandai_make_call --json
kosmo integrations:search "BlandAI" --json
kosmo integrations:list --json Useful BlandAI CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
blandai.blandai_make_call | Write | phone_number, task, voice, wait_for_greeting, record, max_duration | Initiate an AI-powered phone call via BlandAI. The AI agent will follow the provided task instructions and speak using the specified voice. |
blandai.blandai_get_call | Read | call_id | Retrieve details for a specific BlandAI phone call, including status, transcript, duration, and metadata. |
blandai.blandai_list_calls | Read | limit, offset | List BlandAI phone calls with optional pagination. Returns call summaries including status, duration, and phone numbers. |
blandai.blandai_analyze_call | Read | call_id, prompt | Analyze a BlandAI call transcript with a custom prompt. Extract insights, summarize the conversation, or evaluate call outcomes. |
blandai.blandai_get_current_user | Read | none | Get the authenticated BlandAI user's account information. Useful for verifying credentials and checking account details. |
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.