KosmoKrator

productivity

Freshdesk MCP Integration for OpenAI Agents SDK

Connect Freshdesk to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

15 functions 9 read 6 write API key auth
Submit Freshdesk feedback View package source

Connect Freshdesk to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Freshdesk MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-freshdesk": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=freshdesk",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=freshdesk --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Freshdesk instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Freshdesk Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Freshdesk integration catalog.

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

Related Freshdesk Pages

Freshdesk CLIUse direct JSON commands instead of MCP discovery. Freshdesk MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.