Zendesk API MCP Server

Implementation Reference

• src/tools/triggers.js:76-98 (handler)

  The handler function implementing the core logic for the 'create_trigger' MCP tool: constructs trigger data from inputs and invokes the Zendesk client to create the trigger, handling success and error responses.

  handler: async ({ title, description, conditions, actions }) => {
    try {
      const triggerData = {
        title,
        description,
        conditions,
        actions
      };
      
      const result = await zendeskClient.createTrigger(triggerData);
      return {
        content: [{ 
          type: "text", 
          text: `Trigger created successfully!\n\n${JSON.stringify(result, null, 2)}`
        }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error creating trigger: ${error.message}` }],
        isError: true
      };
    }
  }

• src/tools/triggers.js:56-75 (schema)

  Zod input schema defining and validating the parameters for the 'create_trigger' tool: title (required), description (optional), conditions (all/any), and actions.

  schema: {
    title: z.string().describe("Trigger title"),
    description: z.string().optional().describe("Trigger description"),
    conditions: z.object({
      all: z.array(z.object({
        field: z.string().describe("Field to check"),
        operator: z.string().describe("Operator for comparison"),
        value: z.any().describe("Value to compare against")
      })).optional(),
      any: z.array(z.object({
        field: z.string().describe("Field to check"),
        operator: z.string().describe("Operator for comparison"),
        value: z.any().describe("Value to compare against")
      })).optional()
    }).describe("Conditions for the trigger"),
    actions: z.array(z.object({
      field: z.string().describe("Field to modify"),
      value: z.any().describe("Value to set")
    })).describe("Actions to perform when trigger conditions are met")
  },

• src/server.js:48-52 (registration)

  Dynamic registration of the 'create_trigger' tool (included in triggersTools spread into allTools) by calling server.tool with its name, schema, handler, and description.

  allTools.forEach((tool) => {
    server.tool(tool.name, tool.schema, tool.handler, {
      description: tool.description,
    });
  });

• src/zendesk-client.js:216-218 (helper)

  Supporting ZendeskClient method that performs the underlying API call to POST /triggers.json for creating a trigger, used by the tool handler.

  async createTrigger(data) {
    return this.request("POST", "/triggers.json", { trigger: data });
  }