Can I use Braze as a CLI?

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

Can I expose Braze through MCP?

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

Where are Braze credentials stored?

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

Can I deny write access for Braze MCP tools?

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

marketing

Braze CLI for Headless Automation

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

7 functions 7 read 0 write API key auth

Submit Braze feedback View package source

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

Command Shape

# Braze CLI for Headless Automation
kosmokrator integrations:configure braze --set api_key="$BRAZE_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call braze.braze_list_campaigns '{"page":1,"limit":1}' --json

Discovery Before Execution

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

kosmo integrations:docs braze --json
kosmo integrations:docs braze.braze_list_campaigns --json
kosmo integrations:schema braze.braze_list_campaigns --json
kosmo integrations:search "Braze" --json
kosmo integrations:list --json

Useful Braze CLI Functions

Function	Type	Parameters	Description
`braze.braze_list_campaigns`	Read	page, limit	List marketing campaigns from Braze. Returns campaign IDs, names, tags, and creation dates. Use pagination to browse large numbers of campaigns.
`braze.braze_get_campaign`	Read	campaign_id	Get detailed information about a specific Braze campaign, including targeting rules, messaging content, schedule, and analytics.
`braze.braze_list_canvases`	Read	page, limit	List canvases (multi-step customer journeys) from Braze. Returns canvas IDs, names, tags, and creation dates. Use pagination to browse large result sets.
`braze.braze_get_canvas`	Read	canvas_id	Get detailed information about a specific Braze canvas, including steps, targeting rules, messaging channels, and analytics.
`braze.braze_list_users`	Read	external_ids, segment_id, limit	Export users from Braze by segment ID or external IDs. Returns user profile data including attributes and subscription state. Provide either a segment_id to get users in a segment, or external_ids to look up specific users.
`braze.braze_get_user`	Read	external_ids	Get a single user profile from Braze by their external ID. Returns full profile data including attributes, custom attributes, events, purchases, and subscription groups.
`braze.braze_get_current_user`	Read	none	Get the current authenticated Braze user profile. Useful for verifying credentials and identifying the connected workspace.

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 Braze CLI Pages

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