list_tickets
Retrieve and manage Zendesk support tickets with pagination, sorting, and filtering options for efficient customer service workflow organization.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination | |
| per_page | No | Number of tickets per page (max 100) | |
| sort_by | No | Field to sort by | |
| sort_order | No | Sort order (asc or desc) |
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); }