sn_atf
List ServiceNow ATF tests and suites, read legacy results, and return migration guidance for running tests or suites through the supported runner.
Instructions
Automated Test Framework — list tests/suites and read legacy results. Run actions return migration guidance for sn_atf_run.
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": {
"action": "<action>",
"profile": "<profile>"
},
"name": "sn_atf"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait for test/suite completion (default true) | |
| limit | No | Max results (default 20, max 1000) | |
| action | Yes | ATF operation: list tests, list suites, run a test, run a suite, or get results | |
| fields | No | Comma-separated fields to return | |
| offset | No | Deterministic result offset (default 0) | |
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| timeout | No | Max wait time in seconds (default 120 for tests, 300 for suites) | |
| suite_name | No | Filter tests by suite name (for list action) | |
| test_sys_id | No | 32-hex test sys_id (required for run) | |
| execution_id | No | 32-hex execution/result sys_id (required for results action) | |
| suite_sys_id | No | 32-hex suite sys_id (required for run-suite) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| metadata | Yes |