Can I use Crisp as a CLI?

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

Can I expose Crisp through MCP?

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

Where are Crisp credentials stored?

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

Can I deny write access for Crisp MCP tools?

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

messaging

Crisp CLI for Headless Automation

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

7 functions 6 read 1 write API key auth

Submit Crisp feedback View package source

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

Command Shape

# Crisp CLI for Headless Automation
kosmokrator integrations:configure crisp --set api_key="$CRISP_API_KEY" --set website_id="$CRISP_WEBSITE_ID" --enable --read allow --write ask --json
kosmo integrations:call crisp.crisp_list_conversations '{"page":1,"per_page":1}' --json

Discovery Before Execution

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

kosmo integrations:docs crisp --json
kosmo integrations:docs crisp.crisp_list_conversations --json
kosmo integrations:schema crisp.crisp_list_conversations --json
kosmo integrations:search "Crisp" --json
kosmo integrations:list --json

Useful Crisp CLI Functions

Function	Type	Parameters	Description
`crisp.crisp_list_conversations`	Read	page, per_page	List chat conversations from Crisp. Returns conversation sessions with status, participant info, and last message preview. Supports pagination.
`crisp.crisp_get_conversation`	Read	conversation_id	Get details and messages of a specific Crisp conversation. Returns the full message thread including sender info, timestamps, and message content.
`crisp.crisp_send_message`	Write	conversation_id, text, type, from	Send a message in a Crisp conversation. Posts as an operator by default. Use the "type" parameter to send text, notes, or file messages.
`crisp.crisp_list_contacts`	Read	page, per_page	List contacts from Crisp. Returns contact profiles with email, name, and custom data. Supports pagination.
`crisp.crisp_get_contact`	Read	contact_id	Get details of a specific Crisp contact. Returns profile info, custom data, segments, and more.
`crisp.crisp_list_campaigns`	Read	page, per_page	List marketing campaigns from Crisp. Returns campaigns with status, template details, and delivery statistics. Supports pagination.
`crisp.crisp_get_current_user`	Read	none	Get the currently authenticated Crisp user profile. Useful for verifying credentials and identifying the connected operator.

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

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