Run an active-response command
wazuh_active_responseRun active-response commands on agents to block IPs, disable accounts, or null-route hosts. Requires write access and human confirmation before execution.
Instructions
Execute an active-response command on agents — blocking an IP with firewall-drop, disabling an account, null-routing a host. This changes the state of production endpoints and can cut off network access, so it requires WAZUH_ALLOW_WRITE=true and should be confirmed with a human before use.
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": {
"command": "<command>",
"agent_ids": "<agent_ids>"
},
"name": "wazuh_active_response"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| custom | No | True when 'command' is a custom script on the agent rather than a built-in Wazuh AR command. | |
| command | Yes | Command to run. Built-ins: firewall-drop, restart-wazuh, disable-account, host-deny, route-null, win_route-null, netsh. A custom script configured on the agent may also be named. | |
| agent_ids | Yes | Agent IDs to run the command on. There is deliberately no 'all agents' shortcut — name the targets explicitly. | |
| arguments | No | Arguments for the command, e.g. ['1.2.3.4'] as the IP to block for firewall-drop. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||