Vigil reads from the Wazuh manager’s server API (port 55000). The integration is read-only: loaded rules, agents and their log collection, and logtest of a sample event against the ruleset.
Alerts do not come through this integration. Wazuh alerts are ingested
by pointing the Elastic Security or OpenSearch
integration at the Wazuh indexer (wazuh-alerts-4.x-*).
Tools
| Tool | Purpose |
|---|---|
wazuh_list_rules |
List the rules loaded on the manager: id, level, description, groups, if_sid / if_matched_sid parents, MITRE technique ids, file and status. Filterable by rule ids, level (a level or a range such as 7-15), group, free-text search and status. Returns every matching rule, not a page. |
wazuh_list_agents |
List Wazuh agents (id, name, status, groups, OS). Agent 000 is the manager. |
wazuh_agent_log_collection |
Read one agent’s active log collection: its logcollector localfile entries (files, commands, event channels and formats). |
wazuh_test_event |
Run a sample log line through the manager’s ruleset (logtest) and report which rule matched, its level, the decoder, and the full output. Nothing is stored; the logtest session is closed afterwards. |
Vigil configuration
Configure in Settings → Integrations → Wazuh:
| Field | Notes |
|---|---|
| Manager API URL | Required. The manager’s server API, port 55000 by default — not the indexer or the dashboard. |
| Username | Required. A Wazuh API user with read access to rules, agents and logtest. |
| Password | Required. |
| Verify SSL Certificate | Default on. |
| CA Certificate Path | Optional. A PEM trusted for this integration only, in place of the default store — the private CA that signed the server certificate. Ignored when SSL verification is off. |
Settings writes these to the environment as WAZUH_API_URL,
WAZUH_USERNAME, WAZUH_PASSWORD, WAZUH_VERIFY_SSL and
WAZUH_CA_CERT_PATH (see env.example).
The MCP server stays dormant until the API URL, username and password resolve.
Security
- Keep Verify SSL Certificate on for any server you do not control: with verification skipped, the API password is sent to whoever answers at the configured URL.