sn_nl
Translates plain English requests into ServiceNow API calls for queries, aggregates, schema lookups, creates, updates, and batch operations; write actions require explicit execution.
Instructions
Natural language interface for ServiceNow. Translates plain English into ServiceNow API calls. Supports queries, aggregates, schema lookups, creates, updates, and batch operations. Read operations execute immediately; write operations require execute=true.
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": {
"text": "<text>",
"profile": "<profile>"
},
"name": "sn_nl"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Natural language request (e.g. "show all P1 incidents", "how many open changes", "create incident for VPN outage") | |
| force | No | Required for bulk deletes (in addition to confirm) | |
| confirm | No | Required for batch/bulk operations | |
| execute | No | Execute write operations (reads always execute). Default false. | |
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| profile | Yes | Configured ServiceNow profile name (required; no default fallback). | |
| metadata | Yes |