search
Search Zendesk tickets, users, and organizations using query parameters with sorting and pagination options.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query string | |
| sort_by | No | Field to sort by | |
| sort_order | No | Sort order (asc or desc) | |
| page | No | Page number for pagination | |
| per_page | No | Number of results per page (max 100) |
Implementation Reference
- src/tools/search.js:15-31 (handler)The handler function executes the search using zendeskClient.search with provided parameters and returns formatted JSON results or an error message.
handler: async ({ query, sort_by, sort_order, page, per_page }) => { try { const params = { sort_by, sort_order, page, per_page }; const result = await zendeskClient.search(query, params); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error searching: ${error.message}` }], isError: true }; } } - src/tools/search.js:8-14 (schema)Zod schema defining the input parameters for the search tool: query (required string), optional sort_by, sort_order, page, per_page.
schema: { query: z.string().describe("Search query string"), sort_by: z.string().optional().describe("Field to sort by"), sort_order: z.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"), page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of results per page (max 100)") }, - src/server.js:47-52 (registration)Registration of the search tool (included in allTools via searchTools spread) using the MCP server's tool() method in a loop over all imported tools.
// Register each tool with the server allTools.forEach((tool) => { server.tool(tool.name, tool.schema, tool.handler, { description: tool.description, }); });