Search for tickets using RT's TicketSQL query language. Returns summary information for matching tickets, with optional sorting and pagination.

The query is TicketSQL (NOT free-text keyword search). Examples:

• My last 10 tickets: query="Owner = 'CurrentUser'", orderby="Created", order="DESC", per_page=10

• Last 10 tickets created: query="id > 0", orderby="id", order="DESC", per_page=10

• Created after a date: query="Created > '2026-06-01'"

• By requestor: query="Requestor = 'jsmith'" (also Cc, AdminCc, Watcher, Owner)

• ID range: query="id > 261000 AND id < 261700"

• Combined: query="Queue = 'Support' AND Status = 'open' AND LastUpdated > '7 days ago'"

Call the get_ticketsql_grammar tool for the full TicketSQL field/operator reference.

Get the TicketSQL query language reference (fields, operators, date literals, and examples) used by the search_tickets query parameter. Call this when constructing non-trivial searches.

Get complete ticket information by ticket ID, including subject, status, queue, owner, dates, priority, and custom fields.

Get ticket correspondence (comments and replies with attachments). Retrieves all correspondence entries grouped by transaction, showing inline text messages and file attachment metadata.

Download a specific attachment by ID. Returns base64-encoded content with metadata for any file type.

Get ticket hierarchy (parent/child relationships). Builds the complete hierarchy tree if recursive=true, or only immediate relationships if recursive=false.