KosmoKrator

productivity

Freshdesk MCP, CLI, and Lua Integration for AI Agents

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

Freshdesk 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.

Agent Surfaces

Freshdesk CLIHeadless setup, JSON output, direct function calls. Freshdesk MCPExpose selected tools to local MCP clients. Freshdesk LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
freshdesk
route_slug
freshdesk
package
freshdesk
auth_strategy
api_key
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
freshdesk.freshdesk_list_tickets Read read 6 List support tickets from Freshdesk. Supports filtering by status, priority, and pagination. Returns ticket details including subject, status, priority, requester, and assignee.
freshdesk.freshdesk_get_ticket Read read 1 Get full details of a specific support ticket including description, custom fields, conversation history, and associated contacts.
freshdesk.freshdesk_create_ticket Write write 10 Create a new support ticket. Requires a subject, description, and requester email. Optionally set priority and status.
freshdesk.freshdesk_update_ticket Write write 9 Update an existing support ticket. Can change subject, description, status, priority, assignee, and other fields.
freshdesk.freshdesk_delete_ticket Write write 1 Permanently delete a support ticket. This action cannot be undone.
freshdesk.freshdesk_list_contacts Read read 6 List customer contacts from Freshdesk. Supports pagination. Returns contact names, emails, and company associations.
freshdesk.freshdesk_get_contact Read read 1 Get full details of a specific customer contact including email, phone, company, and custom fields.
freshdesk.freshdesk_create_contact Write write 7 Create a new customer contact in Freshdesk. Requires an email address and name.
freshdesk.freshdesk_list_agents Read read 2 List all helpdesk agents. Returns agent details including name, email, availability, and group memberships.
freshdesk.freshdesk_get_agent Read read 1 Get details of a specific helpdesk agent including name, email, role, availability, and group assignments.
freshdesk.freshdesk_list_conversations Read read 1 List all conversations on a ticket — includes public replies and private notes. Shows who posted, the body, and timestamps.
freshdesk.freshdesk_create_reply Write write 4 Post a public reply to a support ticket. The reply is visible to the requester. Use this to respond to customers.
freshdesk.freshdesk_create_note Write write 2 Add a private note to a support ticket. Notes are only visible to agents, not to the customer. Use for internal communication.
freshdesk.freshdesk_list_companies Read read 2 List customer companies from Freshdesk. Supports pagination. Returns company names, domains, and associated contacts.
freshdesk.freshdesk_get_current_user Read read 0 Get the currently authenticated Freshdesk agent. Returns agent name, email, role, and availability. Use this to verify API credentials are working.