Zendesk API MCP Server

Implementation Reference

• src/tools/macros.js:99-120 (handler)

  The handler function that implements the core logic of the 'update_macro' tool, constructing macro data and calling the Zendesk client to update the macro.

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

• src/tools/macros.js:90-98 (schema)

  Zod schema defining the input parameters for the 'update_macro' tool.

  schema: {
    id: z.number().describe("Macro ID to update"),
    title: z.string().optional().describe("Updated macro title"),
    description: z.string().optional().describe("Updated macro description"),
    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:47-52 (registration)

  Generic registration loop that registers the 'update_macro' tool (included via macrosTools in allTools) with the MCP server.

  // Register each tool with the server
  allTools.forEach((tool) => {
    server.tool(tool.name, tool.schema, tool.handler, {
      description: tool.description,
    });
  });

• src/zendesk-client.js:178-180 (helper)

  Helper method in ZendeskClient that performs the API request to update a macro.

  async updateMacro(id, data) {
    return this.request("PUT", `/macros/${id}.json`, { macro: data });
  }