messaging
MessageBird CLI for Headless Automation
Use the MessageBird CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write API key auth
MessageBird 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 MessageBird CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# MessageBird CLI for Headless Automation
kosmokrator integrations:configure messagebird --set api_key="$MESSAGEBIRD_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call messagebird.messagebird_send_sms '{"originator":"example_originator","recipients":"example_recipients","body":"example_body"}' --json Discovery Before Execution
Agents and scripts can inspect MessageBird docs and schemas before choosing a function.
kosmo integrations:docs messagebird --json
kosmo integrations:docs messagebird.messagebird_send_sms --json
kosmo integrations:schema messagebird.messagebird_send_sms --json
kosmo integrations:search "MessageBird" --json
kosmo integrations:list --json Useful MessageBird CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
messagebird.messagebird_send_sms | Write | originator, recipients, body | Send an SMS message to one or more recipients via MessageBird. Specify a sender (originator), one or more phone numbers, and the message body. |
messagebird.messagebird_get_message | Read | id | Retrieve details of a specific MessageBird message by its ID, including status, recipient info, and delivery timestamps. |
messagebird.messagebird_list_messages | Read | limit, offset, status, direction | List sent and received messages from MessageBird. Supports filtering by status and direction, with pagination. |
messagebird.messagebird_list_balance | Read | none | Check your MessageBird account balance. Returns the available amount and payment type (prepaid or postpaid). |
messagebird.messagebird_list_numbers | Read | limit, offset, country_code, number_type | List purchased phone numbers in your MessageBird account. Supports filtering by country code and number type. |
messagebird.messagebird_get_current_user | Read | none | Get the current MessageBird account information, including balance and payment type. |
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.