Can I use Freshchat as a CLI?

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

Can I expose Freshchat through MCP?

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

Where are Freshchat credentials stored?

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

Can I deny write access for Freshchat MCP tools?

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

support

Freshchat MCP, CLI, and Lua Integration for AI Agents

Freshchat integration docs for AI agents: MCP gateway setup, Freshchat CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Bearer token auth

Submit Freshchat feedback View package source

Freshchat for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: freshchat
route_slug: freshchat
package: freshchat
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Freshchat CLIHeadless setup and direct function calls. Freshchat MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Freshchat MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Freshchat.

Freshchat CLI Matrix

Use these pages for direct Freshchat CLI workflows in scripts, CI, cron, and agent wrappers.

CI Freshchat CLI for CI. Cron Jobs Freshchat CLI for cron jobs. Shell Scripts Freshchat CLI for shell scripts. Headless Automation Freshchat CLI for headless automation. Coding Agents Freshchat CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`freshchat.freshchat_list_conversations`	Read `read`	4	List support conversations from Freshchat. Returns paginated results with optional filters for status and inbox. Use this to find recent or unresolved conversations.
`freshchat.freshchat_get_conversation`	Read `read`	1	Get full details of a specific Freshchat conversation by ID, including messages, participants, and metadata.
`freshchat.freshchat_create_conversation`	Write `write`	3	Create a new Freshchat conversation. Specify the user ID, an initial message, and optionally a channel ID. The conversation will be started with the provided message.
`freshchat.freshchat_list_agents`	Read `read`	2	List support agents in Freshchat. Returns paginated results with agent details such as name, email, and availability status.
`freshchat.freshchat_get_agent`	Read `read`	1	Get details of a specific Freshchat agent by ID, including name, email, availability, and assigned conversations.
`freshchat.freshchat_list_groups`	Read `read`	2	List support groups (teams) in Freshchat. Groups organize agents into teams for routing conversations.
`freshchat.freshchat_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Freshchat user. Useful for verifying credentials and identifying the connected account.