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);
```

Zendesk API MCP Server