# mulesoft-ai-chain-project/example-mule-apps architecture

> Architecture diagram of the GitHub repository mulesoft-ai-chain-project/example-mule-apps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mulesoft-ai-chain-project/example-mule-apps
- Repository: https://github.com/mulesoft-ai-chain-project/example-mule-apps

## Overview

This repository is a collection of MuleChain example applications rather than one integrated product. The clearest workflow is the knowledge-store UI: a user creates a store, uploads documents, then queries it; the advanced UI adds agent settings, tools, website crawling, and voice input. Other examples provide image, multimodal, voice, and MCP-catalog interfaces. The excerpts show UI-to-route requests for some flows, but do not establish the server-side storage or model integrations, so those are not inferred here.

Main entry points: [`agent-capabilities-demo/advanced-ui/app/page.tsx`](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/page.tsx) (Agent Workspace), [`agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx`](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx) (LLM Settings), [`mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx`](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx) (Knowledge Store Page), [`agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx`](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx) (Feature Tabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_advanced["Advanced Agent UI"]
  node_advanced_home["Agent Workspace<br/>[page.tsx]"]
  node_settings["LLM Settings"]
  node_create_adv["Create Store<br/>[CreateStore.tsx]"]
  node_tabs["Feature Tabs<br/>[TabsCard.tsx]"]
  node_crawl["Website Crawl<br/>[CrawlWebsite.tsx]"]
  node_upload_adv["Document Upload<br/>[UploadDocument.tsx]"]
  node_query_adv["Knowledge Query<br/>[QueryStore.tsx]"]
  node_voice["Voice Recorder<br/>[VoiceRecorder.tsx]"]
  node_accordion["Settings Accordion<br/>[Accordion.tsx]"]
  node_modal["Settings Modal<br/>[Modal.tsx]"]
  node_get_store["List Stores API<br/>[route.ts]"]
  node_get_tools["Get Tools API<br/>[route.ts]"]
  node_query_api_adv["Query API<br/>[route.tsx]"]
  node_create_api_adv["Create Store API<br/>[route.ts]"]
  node_add_tools["Add Tools API<br/>[route.ts]"]
  node_crawl_api["Crawl API<br/>[route.ts]"]
  node_upload_audio["Audio Upload API<br/>[route.ts]"]
  node_upload_document_api["Document Upload API<br/>[route.ts]"]
  node_token_usage["Token Usage API<br/>[route.ts]"]
end

subgraph group_macstore["Local Knowledge UI"]
  node_mac_home["Knowledge Store Page<br/>[page.tsx]"]
  node_create_mac["Create Store<br/>[CreateStore.tsx]"]
  node_upload_mac["Document Upload<br/>[UploadDocument.tsx]"]
  node_query_mac["Knowledge Query<br/>[QueryStore.tsx]"]
  node_create_api_mac["Create Store API<br/>[route.ts]"]
  node_upload_api_mac["Document Upload API<br/>[route.ts]"]
  node_query_api_mac["Query API<br/>[route.tsx]"]
end

subgraph group_examples["Multimodal Examples"]
  node_image_analyzer["Image Analyzer UI<br/>[app.js]"]
  node_image_read["Image Read Generate UI<br/>[app.js]"]
  node_multimodal_index["Multimodal Entry UI<br/>[index.js]"]
  node_multimodal_script["Multimodal UI Logic<br/>[script.js]"]
  node_voice_demo["Voice Demo UI<br/>[script.js]"]
end

subgraph group_catalog["MCP Catalog"]
  node_mcp_catalog["MCP Catalog UI<br/>[script.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_advanced_home
node_advanced_home -->|"renders"| node_settings
node_advanced_home -->|"renders"| node_create_adv
node_advanced_home -->|"renders"| node_tabs
node_advanced_home -->|"fetches stores"| node_get_store
node_tabs -->|"renders"| node_crawl
node_tabs -->|"renders"| node_upload_adv
node_query_adv -->|"uses"| node_voice
node_query_adv -->|"requests query"| node_query_api_adv
node_settings -->|"fetches tools"| node_get_tools
node_settings -->|"renders"| node_accordion
node_settings -->|"renders"| node_modal
node_user -->|"uses"| node_mac_home
node_mac_home -->|"renders"| node_create_mac
node_mac_home -->|"renders"| node_upload_mac
node_mac_home -->|"renders"| node_query_mac
node_create_mac -->|"creates store"| node_create_api_mac
node_upload_mac -->|"uploads document"| node_upload_api_mac
node_query_mac -->|"requests query"| node_query_api_mac
node_user -->|"uses"| node_image_analyzer
node_user -->|"uses"| node_image_read
node_user -->|"uses"| node_multimodal_index
node_user -->|"uses"| node_voice_demo
node_user -->|"uses"| node_mcp_catalog

click node_advanced_home "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/page.tsx"
click node_settings "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx"
click node_create_adv "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/CreateStore.tsx"
click node_tabs "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx"
click node_crawl "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/CrawlWebsite.tsx"
click node_upload_adv "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/UploadDocument.tsx"
click node_query_adv "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/QueryStore.tsx"
click node_voice "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/VoiceRecorder.tsx"
click node_accordion "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/ui/Accordion.tsx"
click node_modal "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/ui/Modal.tsx"
click node_get_store "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/get-store/route.ts"
click node_get_tools "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/get-tools/route.ts"
click node_query_api_adv "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/query-store/route.tsx"
click node_create_api_adv "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/create-store/route.ts"
click node_add_tools "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/add-tools/route.ts"
click node_crawl_api "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/crawl-website/route.ts"
click node_upload_audio "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/upload-audio/route.ts"
click node_upload_document_api "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/upload-document/route.ts"
click node_token_usage "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/token-usage/route.ts"
click node_mac_home "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx"
click node_create_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/CreateStore.tsx"
click node_upload_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/UploadDocument.tsx"
click node_query_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/QueryStore.tsx"
click node_create_api_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/create-store/route.ts"
click node_upload_api_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/upload-document/route.ts"
click node_query_api_mac "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/query-store/route.tsx"
click node_image_analyzer "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/image-analyzer-app/src/main/resources/webapp/app.js"
click node_image_read "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/image-read-generate-app/src/main/resources/webapp/app.js"
click node_multimodal_index "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/multimodal-demo/src/main/resources/webapp/index.js"
click node_multimodal_script "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/multimodal-demo/src/main/resources/webapp/script.js"
click node_voice_demo "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/voice-demo/src/main/resources/webapp/script.js"
click node_mcp_catalog "https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mcp-catalog-playground/src/main/resources/uiapp/script/script.js"

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_advanced_home,node_settings,node_create_adv,node_tabs,node_crawl,node_upload_adv,node_query_adv,node_voice,node_accordion,node_modal,node_get_store,node_get_tools,node_query_api_adv,node_create_api_adv,node_add_tools,node_crawl_api,node_upload_audio,node_upload_document_api,node_token_usage,node_user toneBlue
class node_mac_home,node_create_mac,node_upload_mac,node_query_mac,node_create_api_mac,node_upload_api_mac,node_query_api_mac toneAmber
class node_image_analyzer,node_image_read,node_multimodal_index,node_multimodal_script,node_voice_demo toneMint
class node_mcp_catalog toneRose
```

## Components

### Advanced Agent UI

- [Agent Workspace](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/page.tsx): `agent-capabilities-demo/advanced-ui/app/page.tsx`
- [LLM Settings](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx): `agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx`
- [Create Store](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/CreateStore.tsx): `agent-capabilities-demo/advanced-ui/app/components/CreateStore.tsx`
- [Feature Tabs](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx): `agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx`
- [Website Crawl](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/CrawlWebsite.tsx): `agent-capabilities-demo/advanced-ui/app/components/CrawlWebsite.tsx`
- [Document Upload](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/UploadDocument.tsx): `agent-capabilities-demo/advanced-ui/app/components/UploadDocument.tsx`
- [Knowledge Query](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/QueryStore.tsx): `agent-capabilities-demo/advanced-ui/app/components/QueryStore.tsx`
- [Voice Recorder](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/VoiceRecorder.tsx): `agent-capabilities-demo/advanced-ui/app/components/VoiceRecorder.tsx`
- [Settings Accordion](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/ui/Accordion.tsx): `agent-capabilities-demo/advanced-ui/app/components/ui/Accordion.tsx`
- [Settings Modal](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/components/ui/Modal.tsx): `agent-capabilities-demo/advanced-ui/app/components/ui/Modal.tsx`
- [List Stores API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/get-store/route.ts): `agent-capabilities-demo/advanced-ui/app/api/get-store/route.ts`
- [Get Tools API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/get-tools/route.ts): `agent-capabilities-demo/advanced-ui/app/api/get-tools/route.ts`
- [Query API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/query-store/route.tsx): `agent-capabilities-demo/advanced-ui/app/api/query-store/route.tsx`
- [Create Store API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/create-store/route.ts): `agent-capabilities-demo/advanced-ui/app/api/create-store/route.ts`
- [Add Tools API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/add-tools/route.ts): `agent-capabilities-demo/advanced-ui/app/api/add-tools/route.ts`
- [Crawl API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/crawl-website/route.ts): `agent-capabilities-demo/advanced-ui/app/api/crawl-website/route.ts`
- [Audio Upload API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/upload-audio/route.ts): `agent-capabilities-demo/advanced-ui/app/api/upload-audio/route.ts`
- [Document Upload API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/upload-document/route.ts): `agent-capabilities-demo/advanced-ui/app/api/upload-document/route.ts`
- [Token Usage API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/agent-capabilities-demo/advanced-ui/app/api/token-usage/route.ts): `agent-capabilities-demo/advanced-ui/app/api/token-usage/route.ts`

### Local Knowledge UI

- [Knowledge Store Page](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx`
- [Create Store](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/CreateStore.tsx): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/CreateStore.tsx`
- [Document Upload](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/UploadDocument.tsx): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/UploadDocument.tsx`
- [Knowledge Query](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/QueryStore.tsx): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/QueryStore.tsx`
- [Create Store API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/create-store/route.ts): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/create-store/route.ts`
- [Document Upload API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/upload-document/route.ts): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/upload-document/route.ts`
- [Query API](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/query-store/route.tsx): `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/api/query-store/route.tsx`

### Multimodal Examples

- [Image Analyzer UI](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/image-analyzer-app/src/main/resources/webapp/app.js): `image-analyzer-app/src/main/resources/webapp/app.js`
- [Image Read Generate UI](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/image-read-generate-app/src/main/resources/webapp/app.js): `image-read-generate-app/src/main/resources/webapp/app.js`
- [Multimodal Entry UI](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/multimodal-demo/src/main/resources/webapp/index.js): `multimodal-demo/src/main/resources/webapp/index.js`
- [Multimodal UI Logic](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/multimodal-demo/src/main/resources/webapp/script.js): `multimodal-demo/src/main/resources/webapp/script.js`
- [Voice Demo UI](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/voice-demo/src/main/resources/webapp/script.js): `voice-demo/src/main/resources/webapp/script.js`

### MCP Catalog

- [MCP Catalog UI](https://github.com/mulesoft-ai-chain-project/example-mule-apps/blob/master/mcp-catalog-playground/src/main/resources/uiapp/script/script.js): `mcp-catalog-playground/src/main/resources/uiapp/script/script.js`

### Other components

- **User**

## Connections

- User → Agent Workspace: uses
- Agent Workspace → LLM Settings: renders (evidence: `agent-capabilities-demo/advanced-ui/app/page.tsx`)
- Agent Workspace → Create Store: renders (evidence: `agent-capabilities-demo/advanced-ui/app/page.tsx`)
- Agent Workspace → Feature Tabs: renders (evidence: `agent-capabilities-demo/advanced-ui/app/page.tsx`)
- Agent Workspace → List Stores API: fetches stores (evidence: `agent-capabilities-demo/advanced-ui/app/page.tsx`)
- Feature Tabs → Website Crawl: renders (evidence: `agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx`)
- Feature Tabs → Document Upload: renders (evidence: `agent-capabilities-demo/advanced-ui/app/components/TabsCard.tsx`)
- Knowledge Query → Voice Recorder: uses (evidence: `agent-capabilities-demo/advanced-ui/app/components/QueryStore.tsx`)
- Knowledge Query → Query API: requests query (evidence: `agent-capabilities-demo/advanced-ui/app/components/QueryStore.tsx`)
- LLM Settings → Get Tools API: fetches tools (evidence: `agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx`)
- LLM Settings → Settings Accordion: renders (evidence: `agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx`)
- LLM Settings → Settings Modal: renders (evidence: `agent-capabilities-demo/advanced-ui/app/components/LLMSettingsPanel.tsx`)
- User → Knowledge Store Page: uses
- Knowledge Store Page → Create Store: renders (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx`)
- Knowledge Store Page → Document Upload: renders (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx`)
- Knowledge Store Page → Knowledge Query: renders (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/page.tsx`)
- Create Store → Create Store API: creates store (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/CreateStore.tsx`)
- Document Upload → Document Upload API: uploads document (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/UploadDocument.tsx`)
- Knowledge Query → Query API: requests query (evidence: `mac-local-knowledge-store-demo/mac-knowledge-store-webapp/app/components/QueryStore.tsx`)
- User → Image Analyzer UI: uses
- User → Image Read Generate UI: uses
- User → Multimodal Entry UI: uses
- User → Voice Demo UI: uses
- User → MCP Catalog UI: uses
