Search tickets

Tickets that match a Zendesk search query, with status, priority, requester and assignee.

MCP tool zendesk_read → search_tickets

read

Runs a Zendesk ticket search and returns the matches without comments. The query uses Zendesk's own keywords, for example status:new, status:pending updated<2026-10-13, assignee:none or requester:amy@example.com. Sorted by the field you pick, newest first by default. Pages hold up to 100 tickets; pass next_cursor back as cursor for the next page. Use get_ticket for the full thread.

Parameters

Parameters: search_tickets
NameTypeDescription
query string required string Zendesk search query, e.g. 'status:new' or 'status:pending updated<2026-10-13'.
sort_by enum enum created_at or updated_at. Default: updated_at.
sort_order enum enum asc or desc. Default: desc.
limit integer integer 1 to 100. Default: 25.
cursor string string Next page cursor from the previous call.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "zendesk_read",
    "arguments": {
      "operation": "search_tickets",
      "arguments": {
        "query": "status:new"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "tickets": [
      {
        "ticket_id": 48230,
        "subject": "Refund for double charge",
        "status": "new",
        "priority": null,
        "requester": "Maya Brandt",
        "assignee": null,
        "group": null,
        "tags": [],
        "created_at": "2026-10-16T06:41:00Z",
        "updated_at": "2026-10-16T06:41:00Z"
      }
    ],
    "next_cursor": null
  },
  "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.