Zendesk API MCP Server

Implementation Reference

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

  The handler function implementing the core logic for the 'update_automation' tool. It conditionally builds the update data object from provided parameters and invokes the Zendesk client to perform the update, returning formatted success or error responses.
  handler: async ({ id, title, description, conditions, actions }) => { try { const automationData = {}; if (title !== undefined) automationData.title = title; if (description !== undefined) automationData.description = description; if (conditions !== undefined) automationData.conditions = conditions; if (actions !== undefined) automationData.actions = actions; const result = await zendeskClient.updateAutomation(id, automationData); return { content: [{ type: "text", text: `Automation updated successfully!\n\n${JSON.stringify(result, null, 2)}` }] }; } catch (error) { return { content: [{ type: "text", text: `Error updating automation: ${error.message}` }], isError: true }; } }
• src/tools/automations.js:103-123 (schema)

  Zod schema defining the input parameters and structure for the 'update_automation' tool, including optional fields for title, description, conditions, and actions.
  schema: { id: z.number().describe("Automation ID to update"), title: z.string().optional().describe("Updated automation title"), description: z.string().optional().describe("Updated automation 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)

  Tool registration block where the automationsTools array (containing 'update_automation') is spread into allTools and each tool is dynamically registered with the MCP server using server.tool().
  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:241-243 (helper)

  ZendeskClient helper method that executes the underlying PUT request to the Zendesk API endpoint for updating an automation.
  async updateAutomation(id, data) { return this.request("PUT", `/automations/${id}.json`, { automation: data }); }