list_automations
Retrieve and manage automation rules from Zendesk with pagination controls to handle large sets of workflow configurations.
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_automations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination | |
| per_page | No | Number of automations per page (max 100) |
Implementation Reference
- src/tools/automations.js:12-28 (handler)Executes the list_automations tool logic: constructs params from input, calls zendeskClient.listAutomations, formats result as JSON text content or error response.
handler: async ({ page, per_page }) => { try { const params = { page, per_page }; const result = await zendeskClient.listAutomations(params); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Error listing automations: ${error.message}` }], isError: true }; } } - src/tools/automations.js:8-11 (schema)Input schema validation using Zod for optional page and per_page parameters.
schema: { page: z.number().optional().describe("Page number for pagination"), per_page: z.number().optional().describe("Number of automations per page (max 100)") }, - src/server.js:31-45 (registration)Collects all tool definitions into allTools array by spreading automationsTools (which includes list_automations).
const allTools = [ ...ticketsTools, ...usersTools, ...organizationsTools, ...groupsTools, ...macrosTools, ...viewsTools, ...triggersTools, ...automationsTools, ...searchTools, ...helpCenterTools, ...supportTools, ...talkTools, ...chatTools, ]; - src/server.js:48-52 (registration)Registers each tool from allTools (including list_automations) with the MCP server via server.tool.
allTools.forEach((tool) => { server.tool(tool.name, tool.schema, tool.handler, { description: tool.description, }); }); - src/zendesk-client.js:229-231 (helper)Helper method in ZendeskClient that makes the API request to list automations.
async listAutomations(params) { return this.request("GET", "/automations.json", null, params); }