list_organizations
Retrieve a paginated list of organizations from Zendesk to manage customer data, with options to control page number and results per page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination | |
| per_page | No | Number of organizations per page (max 100) |
Implementation Reference
- src/tools/organizations.js:12-27 (handler)The MCP tool handler function for 'list_organizations' that prepares parameters, calls the Zendesk client, and returns the result as JSON or an error message.handler: async ({ page, per_page }) => { try { const params = { page, per_page }; const result = await zendeskClient.listOrganizations(params); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error listing organizations: ${error.message}` }], isError: true }; }
- src/tools/organizations.js:8-11 (schema)Zod schema defining optional input parameters 'page' and 'per_page' for pagination.schema: { page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of organizations per page (max 100)") },
- src/server.js:47-52 (registration)Loop that registers all tools, including 'list_organizations', with the MCP server by calling server.tool() for each.// Register each tool with the server allTools.forEach((tool) => { server.tool(tool.name, tool.schema, tool.handler, { description: tool.description, }); });
- src/tools/organizations.js:4-29 (registration)Definition and export of the organizationsTools array containing the 'list_organizations' tool specification.export const organizationsTools = [ { name: "list_organizations", description: "List organizations in Zendesk", schema: { page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of organizations per page (max 100)") }, handler: async ({ page, per_page }) => { try { const params = { page, per_page }; const result = await zendeskClient.listOrganizations(params); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error listing organizations: ${error.message}` }], isError: true }; } } },
- src/zendesk-client.js:122-123 (helper)ZendeskClient method that performs the HTTP GET request to /organizations.json endpoint with provided parameters.async listOrganizations(params) { return this.request("GET", "/organizations.json", null, params);