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 Shell Scripts

Use the Braze CLI for shell scripts 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 Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. 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 Shell Scripts
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. Headless Automation Braze CLI for headless automation. Coding Agents Braze CLI for coding agents.