Zendesk API MCP Server

Implementation Reference

• src/tools/triggers.js:124-146 (handler)

  The main handler function for the "update_trigger" MCP tool. It optionally builds triggerData from provided inputs and delegates to zendeskClient.updateTrigger, handling success/error responses.

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

• src/tools/triggers.js:103-123 (schema)

  Zod input schema for the "update_trigger" tool defining parameters: required id, optional title, description, conditions (all/any), and actions.

  schema: {
    id: z.number().describe("Trigger ID to update"),
    title: z.string().optional().describe("Updated trigger title"),
    description: z.string().optional().describe("Updated 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()
    }).optional().describe("Updated conditions"),
    actions: z.array(z.object({
      field: z.string().describe("Field to modify"),
      value: z.any().describe("Value to set")
    })).optional().describe("Updated actions")
  },

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

  Registration of triggersTools (containing "update_trigger") by spreading into allTools array and registering each via server.tool(name, schema, handler).

  const allTools = [
    ...ticketsTools,
    ...usersTools,
    ...organizationsTools,
    ...groupsTools,
    ...macrosTools,
    ...viewsTools,
    ...triggersTools,
    ...automationsTools,
    ...searchTools,
    ...helpCenterTools,
    ...supportTools,
    ...talkTools,
    ...chatTools,
  ];
  
  // Register each tool with the server
  allTools.forEach((tool) => {
    server.tool(tool.name, tool.schema, tool.handler, {
      description: tool.description,
    });
  });

• src/zendesk-client.js:220-222 (helper)

  Low-level helper method in ZendeskClient that performs the actual API PUT request to update a trigger.

  async updateTrigger(id, data) {
    return this.request("PUT", `/triggers/${id}.json`, { trigger: data });
  }