# wazuh/integrations architecture

> Architecture diagram of the GitHub repository wazuh/integrations, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wazuh/integrations
- Repository: https://github.com/wazuh/integrations

## Overview

This repository is a collection of Wazuh integrations and tools, not one unified runtime. The sampled product workflows include an AI gateway that routes requests into analysis and operational capabilities, a case-management dashboard backed by case services, and a decoder-rule tool with retrieval support. Other integration directories represent separate third-party connectors and utilities. Edges are limited to relationships shown in excerpts, the source index, or the README; unsampled integrations are represented without inferred internal flows.

Main entry points: [`integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py) (Gateway API), [`integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py`](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py) (LLM Agent), [`integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py`](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py) (Alert Planning), [`integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py`](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py) (Dashboard Planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ai["AI Gateway"]
  node_gateway_entry["Gateway Entry<br/>[mcp_llm_gateway.py]"]
  node_gateway_api["Gateway API<br/>[main.py]"]
  node_gateway_config["Gateway Config<br/>[config.py]"]
  node_llm_agent["LLM Agent<br/>[llm.py]"]
  node_prompts["Prompt Library<br/>[prompts.py]"]
  node_alert_planning["Alert Planning<br/>[alert_plan.py]"]
  node_dashboard_planning["Dashboard Planning<br/>[dashboard_plan.py]"]
  node_inventory_qa["Inventory Q&amp;A<br/>[inventory_qa.py]"]
  node_dql_builder["DQL Builder<br/>[dql_builder.py]"]
  node_report_generator["Report Generator"]
  node_opensearch_api["OpenSearch API<br/>[opensearch_api.py]"]
  node_wazuh_api["Wazuh API<br/>[wazuh_api.py]"]
end

subgraph group_cases["Case Management"]
  node_case_application["Case App<br/>[application.tsx]"]
  node_case_ui["Case UI Router<br/>[app.tsx]"]
  node_case_pages["Case Pages<br/>[CaseDetailPage.tsx]"]
  node_case_service["Case Service<br/>[case_service.ts]"]
  node_os_service["OpenSearch Service"]
  node_case_tool["Case Plugin"]
end

subgraph group_decoder["Decoder Tool"]
  node_decoder_app["Decoder Tool<br/>[main.py]"]
  node_rag_engine["Decoder RAG<br/>[rag_engine.py]"]
  node_decoder_model["Decoder Models"]
end

subgraph group_integrations["Other Integrations"]
  node_connectors["Third-Party Integrations"]
  node_threat_intel["Threat Intelligence"]
  node_monitoring["Monitoring Utilities"]
end

node_user(("User"))
node_llm_provider{{"LLM Provider"}}
node_mcp_tools{{"MCP Tools"}}
node_case_user(("Dashboard User"))
node_case_store[("OpenSearch")]
node_decoder_user(("Tool User"))

node_user -->|"starts request"| node_gateway_entry
node_gateway_entry -->|"runs app"| node_gateway_api
node_gateway_entry -->|"reads port"| node_gateway_config
node_gateway_api -->|"uses settings"| node_gateway_config
node_gateway_api -->|"invokes"| node_llm_agent
node_gateway_api -->|"dispatches"| node_alert_planning
node_gateway_api -->|"dispatches"| node_dashboard_planning
node_gateway_api -->|"dispatches"| node_inventory_qa
node_gateway_api -->|"dispatches"| node_dql_builder
node_gateway_api -->|"dispatches"| node_report_generator
node_gateway_api -->|"uses"| node_opensearch_api
node_gateway_api -->|"uses"| node_wazuh_api
node_llm_agent -->|"loads prompts"| node_prompts
node_llm_agent -->|"reads settings"| node_gateway_config
node_llm_agent -.->|"calls model"| node_llm_provider
node_llm_agent -->|"discovers tools"| node_mcp_tools
node_alert_planning -->|"uses"| node_llm_agent
node_alert_planning -->|"uses"| node_prompts
node_alert_planning -->|"queries"| node_opensearch_api
node_dashboard_planning -->|"uses"| node_llm_agent
node_dashboard_planning -->|"queries"| node_opensearch_api
node_inventory_qa -->|"queries"| node_opensearch_api
node_report_generator -->|"uses"| node_dashboard_planning
node_case_user -->|"opens plugin"| node_case_application
node_case_application -->|"renders"| node_case_ui
node_case_ui -->|"routes to"| node_case_pages
node_case_service -->|"reads and writes"| node_os_service
node_os_service -.->|"CRUD operations"| node_case_store
node_decoder_user -.->|"submits logs"| node_decoder_app
node_decoder_app -->|"uses retrieval"| node_rag_engine
node_decoder_app -->|"uses model"| node_decoder_model
node_connectors -->|"includes"| node_threat_intel
node_connectors -->|"includes"| node_monitoring

click node_gateway_entry "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py"
click node_gateway_api "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py"
click node_gateway_config "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/config.py"
click node_llm_agent "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py"
click node_prompts "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/prompts.py"
click node_alert_planning "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py"
click node_dashboard_planning "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py"
click node_inventory_qa "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/inventory_qa.py"
click node_dql_builder "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dql_builder.py"
click node_report_generator "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/report_generator.py"
click node_opensearch_api "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/opensearch_api.py"
click node_wazuh_api "https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/wazuh_api.py"
click node_case_application "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/application.tsx"
click node_case_ui "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/app.tsx"
click node_case_pages "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/pages/CaseDetailPage.tsx"
click node_case_service "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/server/services/case_service.ts"
click node_os_service "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/server/services/opensearch_service.ts"
click node_decoder_app "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/main.py"
click node_rag_engine "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/rag_engine.py"
click node_decoder_model "https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/decoder_ml_enhanced.py"
click node_connectors "https://github.com/wazuh/integrations/tree/main/integrations"
click node_threat_intel "https://github.com/wazuh/integrations/tree/main/integrations/misp"
click node_monitoring "https://github.com/wazuh/integrations/tree/main/integrations/monitoring"
click node_case_tool "https://github.com/wazuh/integrations/tree/main/integrations/wazuh_case_management/server/routes"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway_entry,node_gateway_api,node_gateway_config,node_llm_agent,node_prompts,node_alert_planning,node_dashboard_planning,node_inventory_qa,node_dql_builder,node_report_generator,node_opensearch_api,node_wazuh_api,node_user,node_case_user,node_decoder_user toneBlue
class node_case_application,node_case_ui,node_case_pages,node_case_service,node_os_service,node_case_tool,node_case_store toneAmber
class node_decoder_app,node_rag_engine,node_decoder_model toneMint
class node_connectors,node_threat_intel,node_monitoring toneRose
class node_llm_provider,node_mcp_tools toneIndigo
```

## Components

### AI Gateway

- [Gateway Entry](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py`
- [Gateway API](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`
- [Gateway Config](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/config.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/config.py`
- [LLM Agent](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py`
- [Prompt Library](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/prompts.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/prompts.py`
- [Alert Planning](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py`
- [Dashboard Planning](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py`
- [Inventory Q&A](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/inventory_qa.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/inventory_qa.py`
- [DQL Builder](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dql_builder.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dql_builder.py`
- [Report Generator](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/report_generator.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/report_generator.py`
- [OpenSearch API](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/opensearch_api.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/opensearch_api.py`
- [Wazuh API](https://github.com/wazuh/integrations/blob/main/integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/wazuh_api.py): `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/wazuh_api.py`

### Case Management

- [Case App](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/application.tsx): `integrations/wazuh_case_management/public/application.tsx`
- [Case UI Router](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/app.tsx): `integrations/wazuh_case_management/public/app.tsx`
- [Case Pages](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/public/pages/CaseDetailPage.tsx): `integrations/wazuh_case_management/public/pages/CaseDetailPage.tsx`
- [Case Service](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/server/services/case_service.ts): `integrations/wazuh_case_management/server/services/case_service.ts`
- [OpenSearch Service](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_case_management/server/services/opensearch_service.ts): `integrations/wazuh_case_management/server/services/opensearch_service.ts`
- [Case Plugin](https://github.com/wazuh/integrations/tree/main/integrations/wazuh_case_management/server/routes): `integrations/wazuh_case_management/server/routes`

### Decoder Tool

- [Decoder Tool](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/main.py): `integrations/wazuh_decoder_rule_tool/app/main.py`
- [Decoder RAG](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/rag_engine.py): `integrations/wazuh_decoder_rule_tool/app/rag_engine.py`
- [Decoder Models](https://github.com/wazuh/integrations/blob/main/integrations/wazuh_decoder_rule_tool/app/decoder_ml_enhanced.py): `integrations/wazuh_decoder_rule_tool/app/decoder_ml_enhanced.py`

### Other Integrations

- [Third-Party Integrations](https://github.com/wazuh/integrations/tree/main/integrations): `integrations`
- [Threat Intelligence](https://github.com/wazuh/integrations/tree/main/integrations/misp): `integrations/misp`
- [Monitoring Utilities](https://github.com/wazuh/integrations/tree/main/integrations/monitoring): `integrations/monitoring`

### Other components

- **User**
- **LLM Provider**
- **MCP Tools**
- **Dashboard User**
- **OpenSearch**
- **Tool User**

## Connections

- User → Gateway Entry: starts request (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py`)
- Gateway Entry → Gateway API: runs app (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py`)
- Gateway Entry → Gateway Config: reads port (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_llm_gateway.py`)
- Gateway API → Gateway Config: uses settings (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → LLM Agent: invokes (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → Alert Planning: dispatches (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → Dashboard Planning: dispatches (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → Inventory Q&A: dispatches (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → DQL Builder: dispatches (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → Report Generator: dispatches (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → OpenSearch API: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- Gateway API → Wazuh API: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/main.py`)
- LLM Agent → Prompt Library: loads prompts (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py`)
- LLM Agent → Gateway Config: reads settings (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py`)
- LLM Agent → LLM Provider: calls model
- LLM Agent → MCP Tools: discovers tools (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/llm.py`)
- Alert Planning → LLM Agent: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py`)
- Alert Planning → Prompt Library: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py`)
- Alert Planning → OpenSearch API: queries (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/alert_plan.py`)
- Dashboard Planning → LLM Agent: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py`)
- Dashboard Planning → OpenSearch API: queries (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/dashboard_plan.py`)
- Inventory Q&A → OpenSearch API: queries (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/inventory_qa.py`)
- Report Generator → Dashboard Planning: uses (evidence: `integrations/AI_assistant/mcp-llm-gateway/mcp_gateway/report_generator.py`)
- Dashboard User → Case App: opens plugin (evidence: `integrations/wazuh_case_management/public/application.tsx`)
- Case App → Case UI Router: renders (evidence: `integrations/wazuh_case_management/public/application.tsx`)
- Case UI Router → Case Pages: routes to (evidence: `integrations/wazuh_case_management/public/app.tsx`)
- Case Service → OpenSearch Service: reads and writes (evidence: `integrations/wazuh_case_management/server/services/case_service.ts`)
- OpenSearch Service → OpenSearch: CRUD operations
- Tool User → Decoder Tool: submits logs
- Decoder Tool → Decoder RAG: uses retrieval (evidence: `integrations/wazuh_decoder_rule_tool/app/main.py`)
- Decoder Tool → Decoder Models: uses model (evidence: `integrations/wazuh_decoder_rule_tool/app/main.py`)
- Third-Party Integrations → Threat Intelligence: includes (evidence: `README.md`)
- Third-Party Integrations → Monitoring Utilities: includes (evidence: `README.md`)
