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

Use the Crisp CLI for shell scripts 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 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 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 Shell Scripts
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. Headless Automation Crisp CLI for headless automation. Coding Agents Crisp CLI for coding agents.