MCP server for the Mifos X open banking system that enables AI agents to access financial data and operations for managing clients, loans, savings, and financial transactions.

Installation

JBang (Quick Start)

jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner

Native Executable

./mvnw package -Dnative
./target/mcp-server-1.0.0-SNAPSHOT-runner

Native Build with Container

./mvnw package -Dnative -Dquarkus.native.container-build=true
./target/mcp-server-1.0.0-SNAPSHOT-runner

Features

• MCP compatibility via STDIO/SSE transports
• Environment-independent configuration
• Client management (create, activate, add addresses and personal references)
• Loan product creation and management
• Loan application submission, approval, and disbursement
• Loan repayment processing
• Savings product creation
• Savings account management (create, approve, activate)
• Deposit and withdrawal operations
• Financial operations for the Mifos X ecosystem

Environment Variables

Required

• FINERACT_BASE_URL / MIFOSX_BASE_URL - Base URL of your Fineract instance
• FINERACT_BASIC_AUTH_TOKEN / MIFOSX_BASIC_AUTH_TOKEN - API authentication token

Optional

• FINERACT_TENANT_ID / MIFOS_TENANT_ID - Tenant identifier (default: 'default')

Usage Examples

Create the client using first name: OCTAVIO, last name: PAZ, email address: octaviopaz@mifos.org, mobile number: 5518098299 and external id: OCPZ99

Activate the client OCTAVIO PAZ

Add the address to the client OCTAVIO PAZ. Fields: address type: HOME, address: PLAZA DE LORETO, neighborhood: DOCTOR ALFONZO, number: NUMBER 10, city: CDMX, country: MÉXICO, postal code: 54440, state province: CDMX

Create a default loan product named "SILVER" with short name "ST01", principal 10000, 5 repayments, nominal interest rate 10.0%, repayment frequency 2 MONTHS, currency USD

Apply for an individual loan account for the client OCTAVIO PAZ using loan product SILVER

Notes

Prerequisites: JDK 21+, Maven. The Java implementation uses environment variables with the MIFOSX_ prefix. Test with MCP Inspector using 'npx @modelcontextprotocol/inspector'. A live chatbot is available at https://ai.mifos.community using the Groq provider.