Zendesk API MCP Server

Implementation Reference

• src/tools/tickets.js:20-40 (handler)

  The handler function for the list_tickets MCP tool. It constructs parameters, calls zendeskClient.listTickets, and returns the JSON result or an error response.

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

• src/tools/tickets.js:8-19 (schema)

  Zod schema defining the optional input parameters for the list_tickets tool: page, per_page, sort_by, sort_order.

  schema: {
    page: z.number().optional().describe("Page number for pagination"),
    per_page: z
      .number()
      .optional()
      .describe("Number of tickets per page (max 100)"),
    sort_by: z.string().optional().describe("Field to sort by"),
    sort_order: z
      .enum(["asc", "desc"])
      .optional()
      .describe("Sort order (asc or desc)"),
  },

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

  Registers all imported tools, including list_tickets from ticketsTools, with the MCP server using server.tool().

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

• src/zendesk-client.js:77-79 (helper)

  ZendeskClient helper method that performs the actual API GET request to /tickets.json with provided parameters.

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