list_agents
Retrieve a list of all OSSEC agents managed by the server, including their ID, name, IP address, and status. Optionally filter by agent status to view only active, disconnected, never connected, or pending agents.
Instructions
List all OSSEC agents managed by this server.
Retrieves the full list of agents including their ID, name, IP address, and status information.
Args: status: Optional filter by agent status. Valid values: 'active', 'disconnected', 'never_connected', 'pending'. If not specified, returns all agents.
Returns: JSON array of agent objects with id, name, ip, and status.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_agents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |