# gkbishnoi07/mcp-mifosx architecture

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

- Interactive diagram: https://gitdiagram.com/gkbishnoi07/mcp-mifosx
- Repository: https://github.com/gkbishnoi07/mcp-mifosx

## Overview

Mifos MCP is a set of stateless, framework-agnostic servers exposing Apache Fineract banking operations to MCP-compatible assistants. The principal flow is an assistant invoking a domain tool through a server transport; the implementation adapts the request to Fineract REST and returns a result. Go, Rust, Python, and Java provide distinct implementations, while the repository also contains an agentic copilot and loan-origination services. README statements establish the cross-product integrations; sampled source confirms only selected internal calls, so uncertain internal links are omitted.

Main entry points: [`rust/src/server.rs`](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/server.rs) (Rust MCP server), [`agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java`](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java) (Loan orchestration), [`gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java`](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java) (Agent loop), [`go/server/http_server.go`](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/go/server/http_server.go) (Go transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP implementations"]
  node_go_transport["Go transport<br/>[http_server.go]"]
  node_go_tools["Go banking tools"]
  node_go_adapter["Go adapter<br/>[adapter.go]"]
  node_rust_server["Rust MCP server<br/>[server.rs]"]
  node_rust_registry["Rust tool registry<br/>[registry.rs]"]
  node_rust_domains["Rust domain tools"]
  node_rust_adapter["Rust adapter<br/>[adapter.rs]"]
  node_python_server["Python FastMCP<br/>[mcp_server.py]"]
  node_python_registry["Python tool registry<br/>[registry.py]"]
  node_python_domains["Python domain tools"]
  node_python_adapter["Python MCP adapter<br/>[mcp_adapter.py]"]
  node_java_backoffice["Java backoffice"]
  node_java_recommend["Java recommendations"]
  node_plugin_tools["Fineract MCP tools"]
end

subgraph group_gateway["Copilot gateway"]
  node_chat_controller["Chat endpoint"]
  node_agent_loop["Agent loop<br/>[AgentLoop.java]"]
  node_tool_executor["Fineract tool executor"]
end

subgraph group_origination["Loan origination"]
  node_loan_controller["Loan API"]
  node_loan_orchestrator["Loan orchestration"]
  node_underwriting["Local underwriting"]
  node_case_store[("Loan case state<br/>[LoanCaseStore.java]")]
end

subgraph group_classifier["Document classification"]
  node_classifier_api["Classifier API"]
  node_classifier_service["Statement classifier"]
end

node_assistant(("MCP assistant"))
node_fineract[("Apache Fineract")]
node_chat_user(("Copilot user"))
node_llm["LLM provider"]
node_loan_user(("Loan applicant"))
node_openfn["OpenFn workflow"]
node_ollama["Ollama model"]

node_assistant -->|"invokes tools"| node_go_transport
node_assistant -->|"invokes tools"| node_rust_server
node_assistant -->|"invokes tools"| node_python_server
node_assistant -->|"invokes tools"| node_java_backoffice
node_go_transport -->|"dispatches calls"| node_go_tools
node_go_tools -->|"uses adapter"| node_go_adapter
node_go_adapter -->|"REST requests"| node_fineract
node_rust_server -->|"routes intents"| node_rust_registry
node_rust_server -->|"dispatches tools"| node_rust_domains
node_rust_server -->|"uses adapter"| node_rust_adapter
node_rust_adapter -->|"REST requests"| node_fineract
node_python_server -.->|"registers tools"| node_python_registry
node_python_registry -.->|"exposes domains"| node_python_domains
node_python_domains -->|"uses adapter"| node_python_adapter
node_python_adapter -->|"REST requests"| node_fineract
node_java_backoffice -->|"REST requests"| node_fineract
node_java_recommend -->|"REST requests"| node_fineract
node_plugin_tools -.->|"banking operations"| node_fineract
node_chat_user -->|"sends chat"| node_chat_controller
node_chat_controller -->|"runs turn"| node_agent_loop
node_agent_loop -.->|"requests completion"| node_llm
node_agent_loop -.->|"dispatches tools"| node_tool_executor
node_tool_executor -.->|"calls REST"| node_fineract
node_loan_user -.->|"submits application"| node_loan_controller
node_loan_controller -.->|"starts case"| node_loan_orchestrator
node_loan_orchestrator -->|"stores state"| node_case_store
node_loan_orchestrator -->|"triggers workflow"| node_openfn
node_loan_orchestrator -.->|"fallback assessment"| node_underwriting
node_classifier_api -->|"evaluates documents"| node_classifier_service
node_classifier_service -->|"classifies document"| node_ollama

click node_go_transport "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/go/server/http_server.go"
click node_go_tools "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/go/tools"
click node_go_adapter "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/go/adapter/adapter.go"
click node_rust_server "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/server.rs"
click node_rust_registry "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/registry.rs"
click node_rust_domains "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/rust/src/domains"
click node_rust_adapter "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/adapter.rs"
click node_python_server "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/mcp_server.py"
click node_python_registry "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/tools/registry.py"
click node_python_domains "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/python/tools/domains"
click node_python_adapter "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/tools/mcp_adapter.py"
click node_java_backoffice "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/java/backoffice/src/main/java/org/mifos/community/ai/mcp"
click node_java_recommend "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/java/userrecommendation/src/main/java/org/mifos/community/ai/mcp"
click node_plugin_tools "https://github.com/gkbishnoi07/mcp-mifosx/tree/main/plugin/src/main/java/org/apache/fineract/infrastructure/mcp/tools"
click node_chat_controller "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java"
click node_agent_loop "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java"
click node_tool_executor "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/core/tools/FineractRestToolExecutor.java"
click node_loan_controller "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/controller/LoanController.java"
click node_loan_orchestrator "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java"
click node_underwriting "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LocalUnderwritingService.java"
click node_case_store "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanCaseStore.java"
click node_classifier_api "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java"
click node_classifier_service "https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java"

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_go_transport,node_go_tools,node_go_adapter,node_rust_server,node_rust_registry,node_rust_domains,node_rust_adapter,node_python_server,node_python_registry,node_python_domains,node_python_adapter,node_java_backoffice,node_java_recommend,node_plugin_tools,node_chat_user toneBlue
class node_chat_controller,node_agent_loop,node_tool_executor,node_fineract toneAmber
class node_loan_controller,node_loan_orchestrator,node_underwriting,node_case_store toneMint
class node_classifier_api,node_classifier_service toneRose
class node_assistant,node_llm,node_loan_user,node_openfn,node_ollama toneIndigo
```

## Components

### MCP implementations

- [Go transport](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/go/server/http_server.go): `go/server/http_server.go`
- [Go banking tools](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/go/tools): `go/tools`
- [Go adapter](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/go/adapter/adapter.go): `go/adapter/adapter.go`
- [Rust MCP server](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/server.rs): `rust/src/server.rs`
- [Rust tool registry](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/registry.rs): `rust/src/registry.rs`
- [Rust domain tools](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/rust/src/domains): `rust/src/domains`
- [Rust adapter](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/rust/src/adapter.rs): `rust/src/adapter.rs`
- [Python FastMCP](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/mcp_server.py): `python/mcp_server.py`
- [Python tool registry](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/tools/registry.py): `python/tools/registry.py`
- [Python domain tools](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/python/tools/domains): `python/tools/domains`
- [Python MCP adapter](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/python/tools/mcp_adapter.py): `python/tools/mcp_adapter.py`
- [Java backoffice](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/java/backoffice/src/main/java/org/mifos/community/ai/mcp): `java/backoffice/src/main/java/org/mifos/community/ai/mcp`
- [Java recommendations](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/java/userrecommendation/src/main/java/org/mifos/community/ai/mcp): `java/userrecommendation/src/main/java/org/mifos/community/ai/mcp`
- [Fineract MCP tools](https://github.com/gkbishnoi07/mcp-mifosx/tree/main/plugin/src/main/java/org/apache/fineract/infrastructure/mcp/tools): `plugin/src/main/java/org/apache/fineract/infrastructure/mcp/tools`

### Copilot gateway

- [Chat endpoint](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java): `gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java`
- [Agent loop](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java): `gateway/src/main/java/org/mifos/community/copilot/core/agent/AgentLoop.java`
- [Fineract tool executor](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/gateway/src/main/java/org/mifos/community/copilot/core/tools/FineractRestToolExecutor.java): `gateway/src/main/java/org/mifos/community/copilot/core/tools/FineractRestToolExecutor.java`

### Loan origination

- [Loan API](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/controller/LoanController.java): `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/controller/LoanController.java`
- [Loan orchestration](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java): `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java`
- [Local underwriting](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LocalUnderwritingService.java): `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LocalUnderwritingService.java`
- [Loan case state](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanCaseStore.java): `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanCaseStore.java`

### Document classification

- [Classifier API](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java): `agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java`
- [Statement classifier](https://github.com/gkbishnoi07/mcp-mifosx/blob/main/agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java): `agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java`

### Other components

- **MCP assistant**
- **Apache Fineract**
- **Copilot user**
- **LLM provider**
- **Loan applicant**
- **OpenFn workflow**
- **Ollama model**

## Connections

- MCP assistant → Go transport: invokes tools (evidence: `README.md`)
- MCP assistant → Rust MCP server: invokes tools (evidence: `README.md`)
- MCP assistant → Python FastMCP: invokes tools (evidence: `README.md`)
- MCP assistant → Java backoffice: invokes tools (evidence: `README.md`)
- Go transport → Go banking tools: dispatches calls
- Go banking tools → Go adapter: uses adapter
- Go adapter → Apache Fineract: REST requests (evidence: `README.md`)
- Rust MCP server → Rust tool registry: routes intents (evidence: `rust/src/server.rs`)
- Rust MCP server → Rust domain tools: dispatches tools (evidence: `rust/src/server.rs`)
- Rust MCP server → Rust adapter: uses adapter (evidence: `rust/src/server.rs`)
- Rust adapter → Apache Fineract: REST requests (evidence: `README.md`)
- Python FastMCP → Python tool registry: registers tools
- Python tool registry → Python domain tools: exposes domains
- Python domain tools → Python MCP adapter: uses adapter (evidence: `python/tools/domains/clients.py`)
- Python MCP adapter → Apache Fineract: REST requests (evidence: `README.md`)
- Java backoffice → Apache Fineract: REST requests (evidence: `README.md`)
- Java recommendations → Apache Fineract: REST requests (evidence: `README.md`)
- Fineract MCP tools → Apache Fineract: banking operations
- Copilot user → Chat endpoint: sends chat (evidence: `README.md`)
- Chat endpoint → Agent loop: runs turn (evidence: `gateway/src/main/java/org/mifos/community/copilot/gateway/web/ChatController.java`)
- Agent loop → LLM provider: requests completion
- Agent loop → Fineract tool executor: dispatches tools
- Fineract tool executor → Apache Fineract: calls REST (evidence: `README.md`)
- Loan applicant → Loan API: submits application
- Loan API → Loan orchestration: starts case
- Loan orchestration → Loan case state: stores state (evidence: `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java`)
- Loan orchestration → OpenFn workflow: triggers workflow (evidence: `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java`)
- Loan orchestration → Local underwriting: fallback assessment (evidence: `agentic-banking-openfn/src/main/java/org/community/mifos/agentic/loan/service/LoanOrchestrationService.java`)
- Classifier API → Statement classifier: evaluates documents (evidence: `agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/controller/DocumentClassifierController.java`)
- Statement classifier → Ollama model: classifies document (evidence: `agentic-loan-doc-classifier/src/main/java/org/community/mifos/ai/decision/service/BankStatementClassifierService.java`)
