Zendesk API MCP Server

Implementation Reference

• src/tools/automations.js:12-28 (handler)

  Executes the list_automations tool logic: constructs params from input, calls zendeskClient.listAutomations, formats result as JSON text content or error response.

  handler: async ({ page, per_page }) => {
    try {
      const params = { page, per_page };
      const result = await zendeskClient.listAutomations(params);
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify(result, null, 2)
        }]
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `Error listing automations: ${error.message}` }],
        isError: true
      };
    }
  }

• src/tools/automations.js:8-11 (schema)

  Input schema validation using Zod for optional page and per_page parameters.

  schema: {
    page: z.number().optional().describe("Page number for pagination"),
    per_page: z.number().optional().describe("Number of automations per page (max 100)")
  },

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

  Collects all tool definitions into allTools array by spreading automationsTools (which includes list_automations).

  const allTools = [
    ...ticketsTools,
    ...usersTools,
    ...organizationsTools,
    ...groupsTools,
    ...macrosTools,
    ...viewsTools,
    ...triggersTools,
    ...automationsTools,
    ...searchTools,
    ...helpCenterTools,
    ...supportTools,
    ...talkTools,
    ...chatTools,
  ];

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

  Registers each tool from allTools (including list_automations) with the MCP server via server.tool.

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

• src/zendesk-client.js:229-231 (helper)

  Helper method in ZendeskClient that makes the API request to list automations.

  async listAutomations(params) {
    return this.request("GET", "/automations.json", null, params);
  }