KosmoKrator

other

Freshservice MCP Integration for Claude Agent SDK

Connect Freshservice to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

10 functions 7 read 3 write API key auth

Connect Freshservice to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Freshservice MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Freshservice 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.

Freshservice Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Freshservice integration catalog.

MCP toolSource functionTypeDescription
integration__freshservice__freshservice_list_tickets freshservice.freshservice_list_tickets Read List support tickets from Freshservice. Supports pagination and predefined filters (e.g., new_and_my_open, watching, spam, deleted). Returns ticket summaries including subject, status, priority, and requester.
integration__freshservice__freshservice_get_ticket freshservice.freshservice_get_ticket Read Get full details of a specific Freshservice ticket by its ID, including description, status, priority, requester, assigned agent, and custom fields.
integration__freshservice__freshservice_create_ticket freshservice.freshservice_create_ticket Write Create a new support ticket in Freshservice. Requires a subject and description. Optionally specify the requester email and priority (1=Low, 2=Medium, 3=High, 4=Urgent).
integration__freshservice__freshservice_update_ticket freshservice.freshservice_update_ticket Write Update an existing Freshservice ticket. You can change status, priority, assigned agent, add tags, or modify any writable field.
integration__freshservice__freshservice_delete_ticket freshservice.freshservice_delete_ticket Write Delete a support ticket from Freshservice. This action permanently removes the ticket and its conversations.
integration__freshservice__freshservice_list_agents freshservice.freshservice_list_agents Read List all agents (support staff) in the Freshservice account. Returns agent profiles including name, email, and availability.
integration__freshservice__freshservice_get_agent freshservice.freshservice_get_agent Read Get details of a specific Freshservice agent by their ID, including name, email, role, and availability status.
integration__freshservice__freshservice_list_assets freshservice.freshservice_list_assets Read List IT assets from Freshservice. Supports pagination. Returns asset summaries including name, asset type, and state.
integration__freshservice__freshservice_get_asset freshservice.freshservice_get_asset Read Get full details of a specific Freshservice asset by its display ID, including name, type, state, location, and custom fields.
integration__freshservice__freshservice_get_current_user freshservice.freshservice_get_current_user Read Get the profile of the currently authenticated Freshservice agent. Useful for identifying which agent is performing actions.

Related Freshservice Pages