List macros

Active macros with ID, title and description.

MCP tool zendesk_read → list_macros

read

Lists the active macros your agent user can apply, shared and personal, with title and description when one exists. Filter by part of the title. Use the macro_id with apply_macro.

Parameters

Parameters: list_macros
NameTypeDescription
query string string Only macros whose title contains this text.
limit integer integer 1 to 100. Default: 50.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zendesk_read",
    "arguments": {
      "operation": "list_macros",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "macros": [
      {
        "macro_id": 360011204873,
        "title": "Downgrade and inform",
        "description": "Sets priority to low and tells the requester about possible delay."
      },
      {
        "macro_id": 360011204912,
        "title": "Requester not responding",
        "description": "Reminder for a pending ticket where the requester has not answered."
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.