Search service records

List the records in your SysAid queue that match a text search and filters.

MCP tool sysaid_read → search_service_records

read

Returns one page of records with ID, type, title, status, priority, assignee, requester, due date and creation time, plus next_cursor while more remain. Filters combine: a record must match all of them, as with column filters in the queue. Your agent sees the records your SysAid account can see.

Parameters

Parameters: search_service_records
Name	Type	Description
query string	string	Text to find in ID, title, description and notes, like the search field above the queue.
type string	string	incident, request, problem or change.
status string	string	Status name as list_field_values returns it, for example Open or Pending.
priority string	string	Priority name as list_field_values returns it.
assignee string	string	Name of an agent from list_agents_and_groups, or unassigned.
created_since string	string	ISO date. Only records created on or after it.
sort_by string	string	A queue column name, for example Due Date or Priority. Sorted ascending unless sort_dir is desc.
sort_dir string	string	asc or desc.
cursor string	string	Next page cursor from the previous call.

tools/call

JSON-RPC

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

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "records": [
      {
        "id": 48230,
        "type": "incident",
        "title": "VPN drops every hour",
        "status": "Open",
        "priority": "Priority 2",
        "assignee": null,
        "request_user": "Lena Ortiz",
        "due_date": "2026-10-26T17:00:00Z",
        "created_at": "2026-10-22T21:14:00Z"
      },
      {
        "id": 48244,
        "type": "request",
        "title": "New laptop for onboarding",
        "status": "Open",
        "priority": "Priority 3",
        "assignee": null,
        "request_user": "Sam Okafor",
        "due_date": "2026-10-30T17:00:00Z",
        "created_at": "2026-10-23T06:02:00Z"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Parameters

tools/call

Example response

Sign in once. Your agent does the rest.

Analytics cookies