Can I use VBout as a CLI?

Yes. KosmoKrator exposes a VBout CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose VBout through MCP?

Yes. The KosmoKrator MCP gateway can expose selected VBout tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are VBout credentials stored?

VBout credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for VBout MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

marketing

VBout CLI for Headless Automation

Use the VBout CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write API key auth

Submit VBout feedback View package source

VBout 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 VBout CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# VBout CLI for Headless Automation
kosmokrator integrations:configure vbout --set api_key="$VBOUT_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call vbout.vbout_list_contacts '{"limit":1,"offset":1}' --json

Discovery Before Execution

Agents and scripts can inspect VBout docs and schemas before choosing a function.

kosmo integrations:docs vbout --json
kosmo integrations:docs vbout.vbout_list_contacts --json
kosmo integrations:schema vbout.vbout_list_contacts --json
kosmo integrations:search "VBout" --json
kosmo integrations:list --json

Useful VBout CLI Functions

Function	Type	Parameters	Description
`vbout.vbout_list_contacts`	Read	limit, offset	List contacts from VBout. Returns paginated contact records including email, name, and list membership.
`vbout.vbout_get_contact`	Read	id	Get details for a specific VBout contact by ID, including email, name, custom fields, and list memberships.
`vbout.vbout_create_contact`	Write	email, list_id, first_name, last_name, phone	Add a new contact to a VBout email list. Requires an email address and a list ID. Optionally pass additional fields like first name, last name, or custom fields.
`vbout.vbout_list_campaigns`	Read	limit, offset	List email campaigns from VBout. Returns paginated campaign records including subject, status, and send statistics.
`vbout.vbout_get_campaign`	Read	id	Get details for a specific VBout email campaign by ID, including subject, content, status, and delivery statistics.
`vbout.vbout_get_current_user`	Read	none	Get the currently authenticated VBout user profile. Useful for verifying API credentials and retrieving account information.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related VBout CLI Pages

CI VBout CLI for CI. Cron Jobs VBout CLI for cron jobs. Shell Scripts VBout CLI for shell scripts. Coding Agents VBout CLI for coding agents.