Skip to main content
Glama

sn_query

Read-onlyIdempotent

Query policy-approved ServiceNow tables with structured filters and pagination, selecting concise or detailed fields to fetch the records needed.

Instructions

Query a policy-approved ServiceNow table. Returns records with pagination metadata (record_count, has_more, next_offset; no table total, which would cost a COUNT query: page with next_offset until has_more is false). Field verbosity: an explicit fields list always wins; otherwise response_format="concise" (default) uses the table's safe default field set and response_format="detailed" returns all policy-approved readable fields (same as fields="all"). Responses larger than max_response_bytes are truncated by dropping whole records from the tail, with a hint for fetching the rest. Filter example (a list means AND): structured_query={filter:[{type:"equality",field:"active",operator:"eq",value:true},{type:"text",field:"name",operator:"contains",value:"fleet"}]}. OR: {type:"group",operator:"or",conditions:[...]}.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "table": "<table>",
      "profile": "<profile>"
    },
    "name": "sn_query"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoMaximum records to return (default 20, max 1000)
queryNoLegacy raw ServiceNow encoded query. Disabled by default; accepted only for an explicit bounded sn_query/table policy rule. Prefer structured_query.
tableYesServiceNow table name (e.g. incident, change_request, sys_user)
fieldsNoComma-separated approved fields to return. Always takes precedence over response_format. Omit for the table safe defaults; pass "all" for every policy-approved readable field.
offsetNoPagination offset (max 10000)
orderbyNoSort field. Prefix with - for descending (e.g. -sys_created_on)
profileYesConfigured ServiceNow profile name (required; no default fallback).
display_valueNoDisplay values mode: true, false, or all (default: true)
force_recacheNoFor metadata tables, bypass the per-instance metadata cache and refresh from ServiceNow.
response_formatNoVerbosity when fields is omitted (default "concise"). "concise" returns the safe default set; "detailed" returns every policy-approved readable field. Ignored when fields is provided.concise
structured_queryNoPolicy-authorized structured filters and ordering. Use instead of raw query/orderby; supports bounded equality, set, range, text, null, AND/OR group, and order_by cases.
max_response_bytesNoByte budget for the serialized response (default 100000, min 1000, max 1000000). When exceeded, whole records are dropped from the tail (the JSON is never mangled) and the response gains truncated: true, has_more: true and a hint with the dropped count and the offset, limit, max_response_bytes, fields or response_format to retry with. Cache and timing metadata (under 100 bytes) are not counted.

Output Schema

NameRequiredDescriptionDefault
dataYes
profileYesConfigured ServiceNow profile name (required; no default fallback).
metadataYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changedv2.3.0
    • addedInput schema / definitions
      Added value: +{
      +  "StructuredQueryCondition": {
      +    "anyOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "operator": {
      +            "enum": [
      +              "eq",
      +              "neq"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "equality",
      +            "type": "string"
      +          },
      +          "value": {
      +            "anyOf": [
      +              {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "boolean"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator",
      +          "value"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "operator": {
      +            "enum": [
      +              "in",
      +              "not_in"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "set",
      +            "type": "string"
      +          },
      +          "values": {
      +            "items": {
      +              "anyOf": [
      +                {
      +                  "maxLength": 512,
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                {
      +                  "type": "number"
      +                },
      +                {
      +                  "type": "boolean"
      +                }
      +              ]
      +            },
      +            "maxItems": 20,
      +            "minItems": 1,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator",
      +          "values"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "operator": {
      +            "enum": [
      +              "gt",
      +              "gte",
      +              "lt",
      +              "lte"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "range",
      +            "type": "string"
      +          },
      +          "value": {
      +            "anyOf": [
      +              {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "boolean"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator",
      +          "value"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "lower": {
      +            "anyOf": [
      +              {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "boolean"
      +              }
      +            ]
      +          },
      +          "operator": {
      +            "const": "between",
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "range",
      +            "type": "string"
      +          },
      +          "upper": {
      +            "anyOf": [
      +              {
      +                "maxLength": 512,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              {
      +                "type": "number"
      +              },
      +              {
      +                "type": "boolean"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator",
      +          "lower",
      +          "upper"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "operator": {
      +            "enum": [
      +              "contains",
      +              "not_contains",
      +              "starts_with",
      +              "ends_with"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "text",
      +            "type": "string"
      +          },
      +          "value": {
      +            "maxLength": 512,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator",
      +          "value"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          },
      +          "operator": {
      +            "enum": [
      +              "is_null",
      +              "is_not_null"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "null",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "field",
      +          "operator"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "StructuredQueryFilter": {
      +    "anyOf": [
      +      {
      +        "$ref": "#/definitions/StructuredQueryCondition"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "conditions": {
      +            "items": {
      +              "anyOf": [
      +                {
      +                  "$ref": "#/definitions/StructuredQueryCondition"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "conditions": {
      +                      "items": {
      +                        "anyOf": [
      +                          {
      +                            "$ref": "#/definitions/StructuredQueryCondition"
      +                          },
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "conditions": {
      +                                "items": {
      +                                  "$ref": "#/definitions/StructuredQueryCondition"
      +                                },
      +                                "maxItems": 32,
      +                                "minItems": 1,
      +                                "type": "array"
      +                              },
      +                              "operator": {
      +                                "enum": [
      +                                  "and",
      +                                  "or"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "type": {
      +                                "const": "group",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "type",
      +                              "operator",
      +                              "conditions"
      +                            ],
      +                            "type": "object"
      +                          }
      +                        ]
      +                      },
      +                      "maxItems": 32,
      +                      "minItems": 1,
      +                      "type": "array"
      +                    },
      +                    "operator": {
      +                      "enum": [
      +                        "and",
      +                        "or"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "type": {
      +                      "const": "group",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "type",
      +                    "operator",
      +                    "conditions"
      +                  ],
      +                  "type": "object"
      +                }
      +              ]
      +            },
      +            "maxItems": 32,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "operator": {
      +            "enum": [
      +              "and",
      +              "or"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "group",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "operator",
      +          "conditions"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  }
      +}
    • changedInput schema / properties / max_response_bytes / description
      Previous value: -"Byte budget for the serialized response (default 100000, min 1000, max 1000000). When exceeded, whole records are dropped from the tail (the JSON is never mangled) and the response gains truncated: true plus a hint stating how many records were dropped, the total available, and the exact offset/limit/fields/response_format follow-up arguments to fetch the rest."New value: +"Byte budget for the serialized response (default 100000, min 1000, max 1000000). When exceeded, whole records are dropped from the tail (the JSON is never mangled) and the response gains truncated: true, has_more: true and a hint with the dropped count and the offset, limit, max_response_bytes, fields or response_format to retry with. Cache and timing metadata (under 100 bytes) are not counted."
    • changedInput schema / properties / structured_query / properties / filter / anyOf
      Previous value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "operator": {
      -            "enum": [
      -              "eq",
      -              "neq"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "equality",
      -            "type": "string"
      -          },
      -          "value": {
      -            "anyOf": [
      -              {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "boolean"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator",
      -          "value"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "operator": {
      -            "enum": [
      -              "in",
      -              "not_in"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "set",
      -            "type": "string"
      -          },
      -          "values": {
      -            "items": {
      -              "anyOf": [
      -                {
      -                  "maxLength": 512,
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "number"
      -                },
      -                {
      -                  "type": "boolean"
      -                }
      -              ]
      -            },
      -            "maxItems": 20,
      -            "minItems": 1,
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator",
      -          "values"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "operator": {
      -            "enum": [
      -              "gt",
      -              "gte",
      -              "lt",
      -              "lte"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "range",
      -            "type": "string"
      -          },
      -          "value": {
      -            "anyOf": [
      -              {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "boolean"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator",
      -          "value"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "lower": {
      -            "anyOf": [
      -              {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "boolean"
      -              }
      -            ]
      -          },
      -          "operator": {
      -            "const": "between",
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "range",
      -            "type": "string"
      -          },
      -          "upper": {
      -            "anyOf": [
      -              {
      -                "maxLength": 512,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              {
      -                "type": "number"
      -              },
      -              {
      -                "type": "boolean"
      -              }
      -            ]
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator",
      -          "lower",
      -          "upper"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "operator": {
      -            "enum": [
      -              "contains",
      -              "not_contains",
      -              "starts_with",
      -              "ends_with"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "text",
      -            "type": "string"
      -          },
      -          "value": {
      -            "maxLength": 512,
      -            "minLength": 1,
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator",
      -          "value"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "field": {
      -            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -            "type": "string"
      -          },
      -          "operator": {
      -            "enum": [
      -              "is_null",
      -              "is_not_null"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "null",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "field",
      -          "operator"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "conditions": {
      -        "items": {
      -          "anyOf": [
      -            {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "enum": [
      -                        "eq",
      -                        "neq"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "equality",
      -                      "type": "string"
      -                    },
      -                    "value": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 512,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "number"
      -                        },
      -                        {
      -                          "type": "boolean"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator",
      -                    "value"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "enum": [
      -                        "in",
      -                        "not_in"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "set",
      -                      "type": "string"
      -                    },
      -                    "values": {
      -                      "items": {
      -                        "anyOf": [
      -                          {
      -                            "maxLength": 512,
      -                            "minLength": 1,
      -                            "type": "string"
      -                          },
      -                          {
      -                            "type": "number"
      -                          },
      -                          {
      -                            "type": "boolean"
      -                          }
      -                        ]
      -                      },
      -                      "maxItems": 20,
      -                      "minItems": 1,
      -                      "type": "array"
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator",
      -                    "values"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "enum": [
      -                        "gt",
      -                        "gte",
      -                        "lt",
      -                        "lte"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "range",
      -                      "type": "string"
      -                    },
      -                    "value": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 512,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "number"
      -                        },
      -                        {
      -                          "type": "boolean"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator",
      -                    "value"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "lower": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 512,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "number"
      -                        },
      -                        {
      -                          "type": "boolean"
      -                        }
      -                      ]
      -                    },
      -                    "operator": {
      -                      "const": "between",
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "range",
      -                      "type": "string"
      -                    },
      -                    "upper": {
      -                      "anyOf": [
      -                        {
      -                          "maxLength": 512,
      -                          "minLength": 1,
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "number"
      -                        },
      -                        {
      -                          "type": "boolean"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator",
      -                    "lower",
      -                    "upper"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "enum": [
      -                        "contains",
      -                        "not_contains",
      -                        "starts_with",
      -                        "ends_with"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "text",
      -                      "type": "string"
      -                    },
      -                    "value": {
      -                      "maxLength": 512,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator",
      -                    "value"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "field": {
      -                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                      "type": "string"
      -                    },
      -                    "operator": {
      -                      "enum": [
      -                        "is_null",
      -                        "is_not_null"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "type": {
      -                      "const": "null",
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "type",
      -                    "field",
      -                    "operator"
      -                  ],
      -                  "type": "object"
      -                }
      -              ]
      -            },
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "conditions": {
      -                  "items": {
      -                    "anyOf": [
      -                      {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "operator": {
      -                                "enum": [
      -                                  "eq",
      -                                  "neq"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "equality",
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "anyOf": [
      -                                  {
      -                                    "maxLength": 512,
      -                                    "minLength": 1,
      -                                    "type": "string"
      -                                  },
      -                                  {
      -                                    "type": "number"
      -                                  },
      -                                  {
      -                                    "type": "boolean"
      -                                  }
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator",
      -                              "value"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "operator": {
      -                                "enum": [
      -                                  "in",
      -                                  "not_in"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "set",
      -                                "type": "string"
      -                              },
      -                              "values": {
      -                                "items": {
      -                                  "anyOf": [
      -                                    {
      -                                      "maxLength": 512,
      -                                      "minLength": 1,
      -                                      "type": "string"
      -                                    },
      -                                    {
      -                                      "type": "number"
      -                                    },
      -                                    {
      -                                      "type": "boolean"
      -                                    }
      -                                  ]
      -                                },
      -                                "maxItems": 20,
      -                                "minItems": 1,
      -                                "type": "array"
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator",
      -                              "values"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "operator": {
      -                                "enum": [
      -                                  "gt",
      -                                  "gte",
      -                                  "lt",
      -                                  "lte"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "range",
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "anyOf": [
      -                                  {
      -                                    "maxLength": 512,
      -                                    "minLength": 1,
      -                                    "type": "string"
      -                                  },
      -                                  {
      -                                    "type": "number"
      -                                  },
      -                                  {
      -                                    "type": "boolean"
      -                                  }
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator",
      -                              "value"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "lower": {
      -                                "anyOf": [
      -                                  {
      -                                    "maxLength": 512,
      -                                    "minLength": 1,
      -                                    "type": "string"
      -                                  },
      -                                  {
      -                                    "type": "number"
      -                                  },
      -                                  {
      -                                    "type": "boolean"
      -                                  }
      -                                ]
      -                              },
      -                              "operator": {
      -                                "const": "between",
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "range",
      -                                "type": "string"
      -                              },
      -                              "upper": {
      -                                "anyOf": [
      -                                  {
      -                                    "maxLength": 512,
      -                                    "minLength": 1,
      -                                    "type": "string"
      -                                  },
      -                                  {
      -                                    "type": "number"
      -                                  },
      -                                  {
      -                                    "type": "boolean"
      -                                  }
      -                                ]
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator",
      -                              "lower",
      -                              "upper"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "operator": {
      -                                "enum": [
      -                                  "contains",
      -                                  "not_contains",
      -                                  "starts_with",
      -                                  "ends_with"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "text",
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "maxLength": 512,
      -                                "minLength": 1,
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator",
      -                              "value"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "field": {
      -                                "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                "type": "string"
      -                              },
      -                              "operator": {
      -                                "enum": [
      -                                  "is_null",
      -                                  "is_not_null"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "type": {
      -                                "const": "null",
      -                                "type": "string"
      -                              }
      -                            },
      -                            "required": [
      -                              "type",
      -                              "field",
      -                              "operator"
      -                            ],
      -                            "type": "object"
      -                          }
      -                        ]
      -                      },
      -                      {
      -                        "additionalProperties": false,
      -                        "properties": {
      -                          "conditions": {
      -                            "items": {
      -                              "anyOf": [
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "operator": {
      -                                      "enum": [
      -                                        "eq",
      -                                        "neq"
      -                                      ],
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "equality",
      -                                      "type": "string"
      -                                    },
      -                                    "value": {
      -                                      "anyOf": [
      -                                        {
      -                                          "maxLength": 512,
      -                                          "minLength": 1,
      -                                          "type": "string"
      -                                        },
      -                                        {
      -                                          "type": "number"
      -                                        },
      -                                        {
      -                                          "type": "boolean"
      -                                        }
      -                                      ]
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator",
      -                                    "value"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "operator": {
      -                                      "enum": [
      -                                        "in",
      -                                        "not_in"
      -                                      ],
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "set",
      -                                      "type": "string"
      -                                    },
      -                                    "values": {
      -                                      "items": {
      -                                        "anyOf": [
      -                                          {
      -                                            "maxLength": 512,
      -                                            "minLength": 1,
      -                                            "type": "string"
      -                                          },
      -                                          {
      -                                            "type": "number"
      -                                          },
      -                                          {
      -                                            "type": "boolean"
      -                                          }
      -                                        ]
      -                                      },
      -                                      "maxItems": 20,
      -                                      "minItems": 1,
      -                                      "type": "array"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator",
      -                                    "values"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "operator": {
      -                                      "enum": [
      -                                        "gt",
      -                                        "gte",
      -                                        "lt",
      -                                        "lte"
      -                                      ],
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "range",
      -                                      "type": "string"
      -                                    },
      -                                    "value": {
      -                                      "anyOf": [
      -                                        {
      -                                          "maxLength": 512,
      -                                          "minLength": 1,
      -                                          "type": "string"
      -                                        },
      -                                        {
      -                                          "type": "number"
      -                                        },
      -                                        {
      -                                          "type": "boolean"
      -                                        }
      -                                      ]
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator",
      -                                    "value"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "lower": {
      -                                      "anyOf": [
      -                                        {
      -                                          "maxLength": 512,
      -                                          "minLength": 1,
      -                                          "type": "string"
      -                                        },
      -                                        {
      -                                          "type": "number"
      -                                        },
      -                                        {
      -                                          "type": "boolean"
      -                                        }
      -                                      ]
      -                                    },
      -                                    "operator": {
      -                                      "const": "between",
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "range",
      -                                      "type": "string"
      -                                    },
      -                                    "upper": {
      -                                      "anyOf": [
      -                                        {
      -                                          "maxLength": 512,
      -                                          "minLength": 1,
      -                                          "type": "string"
      -                                        },
      -                                        {
      -                                          "type": "number"
      -                                        },
      -                                        {
      -                                          "type": "boolean"
      -                                        }
      -                                      ]
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator",
      -                                    "lower",
      -                                    "upper"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "operator": {
      -                                      "enum": [
      -                                        "contains",
      -                                        "not_contains",
      -                                        "starts_with",
      -                                        "ends_with"
      -                                      ],
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "text",
      -                                      "type": "string"
      -                                    },
      -                                    "value": {
      -                                      "maxLength": 512,
      -                                      "minLength": 1,
      -                                      "type": "string"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator",
      -                                    "value"
      -                                  ],
      -                                  "type": "object"
      -                                },
      -                                {
      -                                  "additionalProperties": false,
      -                                  "properties": {
      -                                    "field": {
      -                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      -                                      "type": "string"
      -                                    },
      -                                    "operator": {
      -                                      "enum": [
      -                                        "is_null",
      -                                        "is_not_null"
      -                                      ],
      -                                      "type": "string"
      -                                    },
      -                                    "type": {
      -                                      "const": "null",
      -                                      "type": "string"
      -                                    }
      -                                  },
      -                                  "required": [
      -                                    "type",
      -                                    "field",
      -                                    "operator"
      -                                  ],
      -                                  "type": "object"
      -                                }
      -                              ]
      -                            },
      -                            "maxItems": 32,
      -                            "minItems": 1,
      -                            "type": "array"
      -                          },
      -                          "operator": {
      -                            "enum": [
      -                              "and",
      -                              "or"
      -                            ],
      -                            "type": "string"
      -                          },
      -                          "type": {
      -                            "const": "group",
      -                            "type": "string"
      -                          }
      -                        },
      -                        "required": [
      -                          "type",
      -                          "operator",
      -                          "conditions"
      -                        ],
      -                        "type": "object"
      -                      }
      -                    ]
      -                  },
      -                  "maxItems": 32,
      -                  "minItems": 1,
      -                  "type": "array"
      -                },
      -                "operator": {
      -                  "enum": [
      -                    "and",
      -                    "or"
      -                  ],
      -                  "type": "string"
      -                },
      -                "type": {
      -                  "const": "group",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "operator",
      -                "conditions"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "maxItems": 32,
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "operator": {
      -        "enum": [
      -          "and",
      -          "or"
      -        ],
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "group",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "operator",
      -      "conditions"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "$ref": "#/definitions/StructuredQueryFilter"
      +    },
      +    "maxItems": 32,
      +    "minItems": 1,
      +    "type": "array"
      +  },
      +  {
      +    "$ref": "#/definitions/StructuredQueryFilter"
      +  }
      +]
    • addedInput schema / properties / structured_query / properties / filter / description
      Added value: +"One condition or group, or a list read as AND. Example: [{type:\"equality\",field:\"active\",operator:\"eq\",value:true},{type:\"text\",field:\"name\",operator:\"contains\",value:\"fleet\"}]"
    • addedOutput schema / properties / metadata / properties / cache
      Added value: +{
      +  "enum": [
      +    "hit",
      +    "miss",
      +    "bypass",
      +    "mixed"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / metadata / properties / timing
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "total_ms": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "upstream_ms": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "watermark_ms": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "total_ms",
      +    "upstream_ms",
      +    "watermark_ms"
      +  ],
      +  "type": "object"
      +}
  2. Changed20 schema fields changedv2.2.0
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / display_value / enum
      Added value: +[
      +  "true",
      +  "false",
      +  "all"
      +]
    • changedInput schema / properties / fields / description
      Previous value: -"Comma-separated list of fields to return"New value: +"Comma-separated approved fields to return. Always takes precedence over response_format. Omit for the table safe defaults; pass \"all\" for every policy-approved readable field."
    • addedInput schema / properties / force_recache
      Added value: +{
      +  "default": false,
      +  "description": "For metadata tables, bypass the per-instance metadata cache and refresh from ServiceNow.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / limit / default
      Added value: +20
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum records to return (default 20)"New value: +"Maximum records to return (default 20, max 1000)"
    • addedInput schema / properties / limit / maximum
      Added value: +1000
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / max_response_bytes
      Added value: +{
      +  "default": 100000,
      +  "description": "Byte budget for the serialized response (default 100000, min 1000, max 1000000). When exceeded, whole records are dropped from the tail (the JSON is never mangled) and the response gains truncated: true plus a hint stating how many records were dropped, the total available, and the exact offset/limit/fields/response_format follow-up arguments to fetch the rest.",
      +  "maximum": 1000000,
      +  "minimum": 1000,
      +  "type": "integer"
      +}
    • changedInput schema / properties / offset / description
      Previous value: -"Pagination offset"New value: +"Pagination offset (max 10000)"
    • addedInput schema / properties / offset / maximum
      Added value: +10000
    • addedInput schema / properties / offset / minimum
      Added value: +0
    • changedInput schema / properties / offset / type
      Previous value: -"number"New value: +"integer"
    • addedInput schema / properties / profile
      Added value: +{
      +  "description": "Configured ServiceNow profile name (required; no default fallback).",
      +  "maxLength": 128,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / query / description
      Previous value: -"ServiceNow encoded query (e.g. active=true^priority=1). Use ^ for AND, ^OR for OR."New value: +"Legacy raw ServiceNow encoded query. Disabled by default; accepted only for an explicit bounded sn_query/table policy rule. Prefer structured_query."
    • addedInput schema / properties / response_format
      Added value: +{
      +  "default": "concise",
      +  "description": "Verbosity when fields is omitted (default \"concise\"). \"concise\" returns the safe default set; \"detailed\" returns every policy-approved readable field. Ignored when fields is provided.",
      +  "enum": [
      +    "concise",
      +    "detailed"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / structured_query
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Policy-authorized structured filters and ordering. Use instead of raw query/orderby; supports bounded equality, set, range, text, null, AND/OR group, and order_by cases.",
      +  "properties": {
      +    "filter": {
      +      "anyOf": [
      +        {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "operator": {
      +                  "enum": [
      +                    "eq",
      +                    "neq"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "equality",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 512,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "boolean"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "operator": {
      +                  "enum": [
      +                    "in",
      +                    "not_in"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "set",
      +                  "type": "string"
      +                },
      +                "values": {
      +                  "items": {
      +                    "anyOf": [
      +                      {
      +                        "maxLength": 512,
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "number"
      +                      },
      +                      {
      +                        "type": "boolean"
      +                      }
      +                    ]
      +                  },
      +                  "maxItems": 20,
      +                  "minItems": 1,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator",
      +                "values"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "operator": {
      +                  "enum": [
      +                    "gt",
      +                    "gte",
      +                    "lt",
      +                    "lte"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "range",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 512,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "boolean"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "lower": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 512,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "boolean"
      +                    }
      +                  ]
      +                },
      +                "operator": {
      +                  "const": "between",
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "range",
      +                  "type": "string"
      +                },
      +                "upper": {
      +                  "anyOf": [
      +                    {
      +                      "maxLength": 512,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "number"
      +                    },
      +                    {
      +                      "type": "boolean"
      +                    }
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator",
      +                "lower",
      +                "upper"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "operator": {
      +                  "enum": [
      +                    "contains",
      +                    "not_contains",
      +                    "starts_with",
      +                    "ends_with"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "text",
      +                  "type": "string"
      +                },
      +                "value": {
      +                  "maxLength": 512,
      +                  "minLength": 1,
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator",
      +                "value"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "field": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                  "type": "string"
      +                },
      +                "operator": {
      +                  "enum": [
      +                    "is_null",
      +                    "is_not_null"
      +                  ],
      +                  "type": "string"
      +                },
      +                "type": {
      +                  "const": "null",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "type",
      +                "field",
      +                "operator"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "conditions": {
      +              "items": {
      +                "anyOf": [
      +                  {
      +                    "anyOf": [
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "operator": {
      +                            "enum": [
      +                              "eq",
      +                              "neq"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "equality",
      +                            "type": "string"
      +                          },
      +                          "value": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 512,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "number"
      +                              },
      +                              {
      +                                "type": "boolean"
      +                              }
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator",
      +                          "value"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "operator": {
      +                            "enum": [
      +                              "in",
      +                              "not_in"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "set",
      +                            "type": "string"
      +                          },
      +                          "values": {
      +                            "items": {
      +                              "anyOf": [
      +                                {
      +                                  "maxLength": 512,
      +                                  "minLength": 1,
      +                                  "type": "string"
      +                                },
      +                                {
      +                                  "type": "number"
      +                                },
      +                                {
      +                                  "type": "boolean"
      +                                }
      +                              ]
      +                            },
      +                            "maxItems": 20,
      +                            "minItems": 1,
      +                            "type": "array"
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator",
      +                          "values"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "operator": {
      +                            "enum": [
      +                              "gt",
      +                              "gte",
      +                              "lt",
      +                              "lte"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "range",
      +                            "type": "string"
      +                          },
      +                          "value": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 512,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "number"
      +                              },
      +                              {
      +                                "type": "boolean"
      +                              }
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator",
      +                          "value"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "lower": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 512,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "number"
      +                              },
      +                              {
      +                                "type": "boolean"
      +                              }
      +                            ]
      +                          },
      +                          "operator": {
      +                            "const": "between",
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "range",
      +                            "type": "string"
      +                          },
      +                          "upper": {
      +                            "anyOf": [
      +                              {
      +                                "maxLength": 512,
      +                                "minLength": 1,
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "number"
      +                              },
      +                              {
      +                                "type": "boolean"
      +                              }
      +                            ]
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator",
      +                          "lower",
      +                          "upper"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "operator": {
      +                            "enum": [
      +                              "contains",
      +                              "not_contains",
      +                              "starts_with",
      +                              "ends_with"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "text",
      +                            "type": "string"
      +                          },
      +                          "value": {
      +                            "maxLength": 512,
      +                            "minLength": 1,
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator",
      +                          "value"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "field": {
      +                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                            "type": "string"
      +                          },
      +                          "operator": {
      +                            "enum": [
      +                              "is_null",
      +                              "is_not_null"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "type": {
      +                            "const": "null",
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "type",
      +                          "field",
      +                          "operator"
      +                        ],
      +                        "type": "object"
      +                      }
      +                    ]
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "conditions": {
      +                        "items": {
      +                          "anyOf": [
      +                            {
      +                              "anyOf": [
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "operator": {
      +                                      "enum": [
      +                                        "eq",
      +                                        "neq"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "equality",
      +                                      "type": "string"
      +                                    },
      +                                    "value": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 512,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "number"
      +                                        },
      +                                        {
      +                                          "type": "boolean"
      +                                        }
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator",
      +                                    "value"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "operator": {
      +                                      "enum": [
      +                                        "in",
      +                                        "not_in"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "set",
      +                                      "type": "string"
      +                                    },
      +                                    "values": {
      +                                      "items": {
      +                                        "anyOf": [
      +                                          {
      +                                            "maxLength": 512,
      +                                            "minLength": 1,
      +                                            "type": "string"
      +                                          },
      +                                          {
      +                                            "type": "number"
      +                                          },
      +                                          {
      +                                            "type": "boolean"
      +                                          }
      +                                        ]
      +                                      },
      +                                      "maxItems": 20,
      +                                      "minItems": 1,
      +                                      "type": "array"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator",
      +                                    "values"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "operator": {
      +                                      "enum": [
      +                                        "gt",
      +                                        "gte",
      +                                        "lt",
      +                                        "lte"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "range",
      +                                      "type": "string"
      +                                    },
      +                                    "value": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 512,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "number"
      +                                        },
      +                                        {
      +                                          "type": "boolean"
      +                                        }
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator",
      +                                    "value"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "lower": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 512,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "number"
      +                                        },
      +                                        {
      +                                          "type": "boolean"
      +                                        }
      +                                      ]
      +                                    },
      +                                    "operator": {
      +                                      "const": "between",
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "range",
      +                                      "type": "string"
      +                                    },
      +                                    "upper": {
      +                                      "anyOf": [
      +                                        {
      +                                          "maxLength": 512,
      +                                          "minLength": 1,
      +                                          "type": "string"
      +                                        },
      +                                        {
      +                                          "type": "number"
      +                                        },
      +                                        {
      +                                          "type": "boolean"
      +                                        }
      +                                      ]
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator",
      +                                    "lower",
      +                                    "upper"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "operator": {
      +                                      "enum": [
      +                                        "contains",
      +                                        "not_contains",
      +                                        "starts_with",
      +                                        "ends_with"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "text",
      +                                      "type": "string"
      +                                    },
      +                                    "value": {
      +                                      "maxLength": 512,
      +                                      "minLength": 1,
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator",
      +                                    "value"
      +                                  ],
      +                                  "type": "object"
      +                                },
      +                                {
      +                                  "additionalProperties": false,
      +                                  "properties": {
      +                                    "field": {
      +                                      "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                      "type": "string"
      +                                    },
      +                                    "operator": {
      +                                      "enum": [
      +                                        "is_null",
      +                                        "is_not_null"
      +                                      ],
      +                                      "type": "string"
      +                                    },
      +                                    "type": {
      +                                      "const": "null",
      +                                      "type": "string"
      +                                    }
      +                                  },
      +                                  "required": [
      +                                    "type",
      +                                    "field",
      +                                    "operator"
      +                                  ],
      +                                  "type": "object"
      +                                }
      +                              ]
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "conditions": {
      +                                  "items": {
      +                                    "anyOf": [
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "operator": {
      +                                            "enum": [
      +                                              "eq",
      +                                              "neq"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "equality",
      +                                            "type": "string"
      +                                          },
      +                                          "value": {
      +                                            "anyOf": [
      +                                              {
      +                                                "maxLength": 512,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              {
      +                                                "type": "number"
      +                                              },
      +                                              {
      +                                                "type": "boolean"
      +                                              }
      +                                            ]
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator",
      +                                          "value"
      +                                        ],
      +                                        "type": "object"
      +                                      },
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "operator": {
      +                                            "enum": [
      +                                              "in",
      +                                              "not_in"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "set",
      +                                            "type": "string"
      +                                          },
      +                                          "values": {
      +                                            "items": {
      +                                              "anyOf": [
      +                                                {
      +                                                  "maxLength": 512,
      +                                                  "minLength": 1,
      +                                                  "type": "string"
      +                                                },
      +                                                {
      +                                                  "type": "number"
      +                                                },
      +                                                {
      +                                                  "type": "boolean"
      +                                                }
      +                                              ]
      +                                            },
      +                                            "maxItems": 20,
      +                                            "minItems": 1,
      +                                            "type": "array"
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator",
      +                                          "values"
      +                                        ],
      +                                        "type": "object"
      +                                      },
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "operator": {
      +                                            "enum": [
      +                                              "gt",
      +                                              "gte",
      +                                              "lt",
      +                                              "lte"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "range",
      +                                            "type": "string"
      +                                          },
      +                                          "value": {
      +                                            "anyOf": [
      +                                              {
      +                                                "maxLength": 512,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              {
      +                                                "type": "number"
      +                                              },
      +                                              {
      +                                                "type": "boolean"
      +                                              }
      +                                            ]
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator",
      +                                          "value"
      +                                        ],
      +                                        "type": "object"
      +                                      },
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "lower": {
      +                                            "anyOf": [
      +                                              {
      +                                                "maxLength": 512,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              {
      +                                                "type": "number"
      +                                              },
      +                                              {
      +                                                "type": "boolean"
      +                                              }
      +                                            ]
      +                                          },
      +                                          "operator": {
      +                                            "const": "between",
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "range",
      +                                            "type": "string"
      +                                          },
      +                                          "upper": {
      +                                            "anyOf": [
      +                                              {
      +                                                "maxLength": 512,
      +                                                "minLength": 1,
      +                                                "type": "string"
      +                                              },
      +                                              {
      +                                                "type": "number"
      +                                              },
      +                                              {
      +                                                "type": "boolean"
      +                                              }
      +                                            ]
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator",
      +                                          "lower",
      +                                          "upper"
      +                                        ],
      +                                        "type": "object"
      +                                      },
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "operator": {
      +                                            "enum": [
      +                                              "contains",
      +                                              "not_contains",
      +                                              "starts_with",
      +                                              "ends_with"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "text",
      +                                            "type": "string"
      +                                          },
      +                                          "value": {
      +                                            "maxLength": 512,
      +                                            "minLength": 1,
      +                                            "type": "string"
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator",
      +                                          "value"
      +                                        ],
      +                                        "type": "object"
      +                                      },
      +                                      {
      +                                        "additionalProperties": false,
      +                                        "properties": {
      +                                          "field": {
      +                                            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +                                            "type": "string"
      +                                          },
      +                                          "operator": {
      +                                            "enum": [
      +                                              "is_null",
      +                                              "is_not_null"
      +                                            ],
      +                                            "type": "string"
      +                                          },
      +                                          "type": {
      +                                            "const": "null",
      +                                            "type": "string"
      +                                          }
      +                                        },
      +                                        "required": [
      +                                          "type",
      +                                          "field",
      +                                          "operator"
      +                                        ],
      +                                        "type": "object"
      +                                      }
      +                                    ]
      +                                  },
      +                                  "maxItems": 32,
      +                                  "minItems": 1,
      +                                  "type": "array"
      +                                },
      +                                "operator": {
      +                                  "enum": [
      +                                    "and",
      +                                    "or"
      +                                  ],
      +                                  "type": "string"
      +                                },
      +                                "type": {
      +                                  "const": "group",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "type",
      +                                "operator",
      +                                "conditions"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        "maxItems": 32,
      +                        "minItems": 1,
      +                        "type": "array"
      +                      },
      +                      "operator": {
      +                        "enum": [
      +                          "and",
      +                          "or"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "type": {
      +                        "const": "group",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "operator",
      +                      "conditions"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "maxItems": 32,
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "operator": {
      +              "enum": [
      +                "and",
      +                "or"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "const": "group",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "operator",
      +            "conditions"
      +          ],
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "order_by": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "direction": {
      +            "default": "asc",
      +            "enum": [
      +              "asc",
      +              "desc"
      +            ],
      +            "type": "string"
      +          },
      +          "field": {
      +            "pattern": "^[a-z][a-z0-9_]{0,79}$",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "field"
      +        ],
      +        "type": "object"
      +      },
      +      "maxItems": 4,
      +      "minItems": 1,
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "table"
      -]New value: +[
      +  "table",
      +  "profile"
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "dropped_records": {
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "has_more": {
      +          "type": "boolean"
      +        },
      +        "hint": {
      +          "type": "string"
      +        },
      +        "next_offset": {
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "record_count": {
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "results": {
      +          "items": {},
      +          "type": "array"
      +        },
      +        "total": {
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "truncated": {
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "record_count",
      +        "has_more",
      +        "results"
      +      ],
      +      "type": "object"
      +    },
      +    "metadata": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "kind": {
      +          "enum": [
      +            "single",
      +            "collection",
      +            "operation"
      +          ],
      +          "type": "string"
      +        },
      +        "limits": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "max_bytes": {
      +              "maximum": 14680064,
      +              "minimum": 1000,
      +              "type": "integer"
      +            },
      +            "max_records": {
      +              "exclusiveMinimum": 0,
      +              "maximum": 9007199254740991,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "max_records",
      +            "max_bytes"
      +          ],
      +          "type": "object"
      +        },
      +        "pagination": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "mode": {
      +                  "const": "none",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "has_more": {
      +                  "type": "boolean"
      +                },
      +                "limit": {
      +                  "exclusiveMinimum": 0,
      +                  "maximum": 9007199254740991,
      +                  "type": "integer"
      +                },
      +                "mode": {
      +                  "const": "offset",
      +                  "type": "string"
      +                },
      +                "next_offset": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "offset": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                },
      +                "order_by": {
      +                  "items": {
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "maxItems": 8,
      +                  "minItems": 1,
      +                  "type": "array"
      +                },
      +                "recovery": {
      +                  "const": "adjust_request_and_retry_same_offset",
      +                  "type": "string"
      +                },
      +                "returned": {
      +                  "maximum": 9007199254740991,
      +                  "minimum": 0,
      +                  "type": "integer"
      +                }
      +              },
      +              "required": [
      +                "mode",
      +                "limit",
      +                "offset",
      +                "returned",
      +                "has_more",
      +                "order_by"
      +              ],
      +              "type": "object"
      +            }
      +          ]
      +        },
      +        "record_count": {
      +          "maximum": 9007199254740991,
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "truncation": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "dropped_records": {
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "reason": {
      +              "enum": [
      +                "record_limit",
      +                "byte_limit"
      +              ],
      +              "type": "string"
      +            },
      +            "truncated": {
      +              "type": "boolean"
      +            }
      +          },
      +          "required": [
      +            "truncated"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "kind",
      +        "record_count",
      +        "limits",
      +        "pagination",
      +        "truncation"
      +      ],
      +      "type": "object"
      +    },
      +    "profile": {
      +      "description": "Configured ServiceNow profile name (required; no default fallback).",
      +      "maxLength": 128,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "data",
      +    "metadata",
      +    "profile"
      +  ],
      +  "type": "object"
      +}
  3. First observedv1.0.0

TDQS

A4.2/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, openWorld and non-destructive, yet the description still adds substantial behavioral detail: truncation drops whole records from the tail rather than mangling JSON, sets truncated/has_more and supplies a retry hint with the exact offset/limit/fields to use, and excludes sub-100-byte cache/timing metadata from the byte budget. That is meaningful context an agent could not derive from the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then pagination, verbosity, truncation, and filtering in a logical order. The sentences are dense and semicolon-heavy, and the fields/response_format precedence is stated twice (once here, once in the schema), but there is no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter tool with nested query objects, this covers the behaviors an agent is most likely to get wrong: pagination termination, truncation recovery, and verbosity selection. An output schema exists so return values need no explanation, and remaining gaps (profile selection semantics, orderby vs structured_query.order_by precedence, force_recache) are documented in the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, but the description reinforces the highest-risk interaction: an explicit fields list always wins, concise is the default safe set, and detailed equals fields="all". It also supplies a worked structured_query example showing that a filter list means AND and how an OR group nests, adding comprehension value beyond the schema text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Query a policy-approved ServiceNow table") and immediately characterizes the return shape (records plus pagination metadata). It is clearly a multi-record read, which implicitly separates it from record-level siblings like sn_get or write siblings like sn_create/sn_update, but it never names an alternative explicitly, so it falls short of the top band.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete operational guidance: page with next_offset until has_more is false, use fields when you want a specific set, use concise vs detailed otherwise, and note that no table total is provided because it would cost a COUNT query. It does not say when to prefer sn_aggregate over this tool for totals, and legacy query guidance lives mainly in the schema, so no explicit alternatives or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.