list_tickets
Retrieve and manage Zendesk support tickets with pagination, sorting, and filtering options for efficient customer service workflow organization.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_tickets"
}
}Input 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); }