Skip to main content
Glama
mcp-server-wazuh

mcp-server-wazuh

mcp-server-wazuh

stdio MCP server for Wazuh 5. It reads the manager API on port 55000 (agents, groups, cluster, MITRE) and the indexer on port 9200 (events, findings, vulnerability state).

Wazuh 5 removed the 4.x manager paths /manager, /rules, /syscheck, /sca and /vulnerability. Existing public servers such as gbrigandi/mcp-server-wazuh still call those paths, so this package talks to the 5.0 API instead of forking them. Rule matches are findings in wazuh-findings-v5*, not wazuh-alerts-*.

Install

apt install mcp-server-wazuh
apt install mcprack-mcp-server-wazuh

Related MCP server: Wazuh MCP Server

Environment

Variable

Secret

Default

Meaning

WAZUH_API_URL

no

https://127.0.0.1:55000

Manager API base URL

WAZUH_API_USER

yes

–

API user. Used once to obtain a JWT

WAZUH_API_PASSWORD

yes

–

API password

WAZUH_INDEXER_URL

no

https://127.0.0.1:9200

Indexer base URL

WAZUH_INDEXER_USER

yes

–

Indexer user

WAZUH_INDEXER_PASSWORD

yes

–

Indexer password

WAZUH_READ_ONLY

no

true

Hide restart_agents

WAZUH_VERIFY_TLS

no

true

Verify manager and indexer certificates

WAZUH_TIMEOUT

no

30

Seconds per request

WAZUH_MAX_CHARS

no

100000

Truncate larger tool output

WAZUH_EVENTS_INDEX

no

wazuh-events-v5*

Events data stream

WAZUH_FINDINGS_INDEX

no

wazuh-findings-v5*

Findings data stream

WAZUH_VULN_INDEX

no

wazuh-states-vulnerabilities

Vulnerability state index

The JWT is refreshed in-process and is never printed. A 401 fetches a new token once.

Tools

Tool

Title

Annotation

Backend

get_api_info

API Info

read-only

manager GET /

list_agents

List Agents

read-only

manager GET /agents

get_agent

Get Agent

read-only

manager GET /agents/{id}

get_agents_summary

Agents Summary

read-only

manager GET /agents/summary

list_groups

List Groups

read-only

manager GET /groups

get_cluster_status

Cluster Status

read-only

manager GET /cluster/status

list_cluster_nodes

List Cluster Nodes

read-only

manager GET /cluster/nodes

search_mitre

Search MITRE

read-only

manager GET /mitre/techniques

search_events

Search Events

read-only

indexer

search_findings

Search Findings

read-only

indexer

search_vulnerabilities

Search Vulnerabilities

read-only

indexer

restart_agents

Restart Agents

destructive

manager, only when WAZUH_READ_ONLY=false

restart_agents interrupts agents. Ask before calling it. Wazuh 5 may reject the restart endpoint.

Development

PYTHONPATH=src python3 -m pytest

Available Tools

11 tools
get_agentGet AgentC
Read-onlyIdempotent

Read one agent from the manager API.

Inputs: agent_id (required). Returns: result

get_agents_summaryAgents SummaryA
Read-onlyIdempotent

Read agent counts grouped by status.

Inputs: no named parameters. Returns: result

get_api_infoAPI InfoA
Read-onlyIdempotent

Read the Wazuh manager API root. Confirms the host and the running build.

Inputs: no named parameters. Returns: result

get_cluster_statusCluster StatusA
Read-onlyIdempotent

Read whether the manager cluster is enabled and healthy.

Inputs: no named parameters. Returns: result

list_agentsList AgentsC
Read-onlyIdempotent

List agents from the Wazuh 5 manager API.

Inputs: limit, offset, search, status. Returns: result

list_cluster_nodesList Cluster NodesB
Read-onlyIdempotent

List Wazuh cluster nodes.

Inputs: no named parameters. Returns: result

list_groupsList GroupsC
Read-onlyIdempotent

List agent groups.

Inputs: limit, offset. Returns: result

search_eventsSearch EventsC
Read-onlyIdempotent

Search the wazuh-events-v5 data stream on the indexer.

Inputs: limit, query, offset, agent_id. Returns: result

search_findingsSearch FindingsA
Read-onlyIdempotent

Search rule matches in the wazuh-findings-v5 data stream. Wazuh 5 calls these findings, not alerts.

Inputs: limit, query, offset, agent_id. Returns: result

search_mitreSearch MITREB
Read-onlyIdempotent

List MITRE techniques known to the manager.

Inputs: limit, offset. Returns: result

search_vulnerabilitiesSearch VulnerabilitiesA
Read-onlyIdempotent

Search the wazuh-states-vulnerabilities index, newest detections first. Example query: vulnerability.severity:Critical

Inputs: limit, query, offset, agent_id. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 11 tools

    Disambiguation4/5

    Each tool maps to a distinct resource (agents, groups, cluster, MITRE, events, findings, vulnerabilities) and the descriptions explicitly clarify the trickiest pair, search_events vs search_findings. The main residual overlap is that events and findings are closely related data streams, and get_agents_summary vs list_agents require reading descriptions to separate counts from records.

    Naming Consistency5/5

    Consistent snake_case verb_noun pattern throughout: get_*, list_*, and search_* all used predictably against the noun they operate on. The few multi-word nouns (get_agents_summary, get_cluster_status) still follow the same verb-first convention.

    Tool Count5/5

    Eleven tools is well within the ideal 3-15 range and every tool covers a distinct slice of the Wazuh read surface. No redundant or obviously filler tools are present.

    Completeness4/5

    The set covers the main read workflows: manager info, agents, groups, cluster health/nodes, MITRE, events, findings, and vulnerabilities. Gaps are minor but real: list_groups has no companion get_group, there is no way to fetch a single finding/event/vulnerability record by ID, and rules/decoders or manager logs are absent.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      Enables querying a remote Wazuh deployment via MCP, covering Manager API (agents, rules, inventory, configuration) and Indexer (alerts, vulnerabilities) with 34 tools and reports, read-only by default.
      34
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to converse in plain language with a Wazuh SIEM deployment, querying and aggregating alerts, hunting threats, triaging vulnerabilities, running compliance checks, and executing or rolling back active responses across multi-cluster environments. Works with both cloud and fully local, air-gapped LLM clients while enforcing scoped, audited access to the security tools.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes Wazuh SIEM data and actions—including agents, alerts, vulnerabilities, rules, decoders, active response, and Wazuh 5 Sigma rules, Detectors, and content promotion—as Model Context Protocol tools that LLM clients can call over HTTP.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to query and manipulate a Wazuh SIEM deployment through its manager, Indexer, and dashboard REST APIs, covering agents, alerts, vulnerabilities, rules, decoders, active response, and content promotion.
      MIT