Integrations
Provides integration with Apache Fineract, likely offering capabilities for financial inclusion software functionalities and microfinance operations through the Mifos X AI platform.
Mifos X - AI - Model Context Protocol (MCP) for Apache Fineract®
This project provides Model Context Protocol (MCP) servers for interacting with the Apache Fineract API, enabling AI agents to access financial data and operations. Implementations are available in Python, Java (Quarkus), and Node.js.
MCP Developer Tools
Use the MCP Inspector to test and debug your server:
This starts a local web UI to connect to your MCP server via STDIO or SSE.
Getting Started
1. Choose Your Implementation
Python (Flask)
Prerequisites: Python 3.8+, flask
, mcp.server.fastmcp
Steps:
- Install dependencies:Copy
Note for zsh users: If you're using zsh, be sure to quote extras to avoid shell expansion errors:
Copy - Run the server:Copy
Java (Quarkus)
Prerequisites: JDK 17+, Maven
Steps:
- Configure environment variables in your shell or IDE:Copy
- Run via JBang (for quick execution):Copy
- (Optional) Build a native executable:Copy
Node.js
Prerequisites: Node.js 16+, npm
Steps:
- Install dependencies:Copy
- Configure environment variables in
.env
:Copy - Run the server:Copy
- Test with the built-in
inspect
script:Copy
Configuration
All implementations require the following environment variables:
Variable | Description |
---|---|
FINERACT_BASE_URL | Base URL of your Fineract instance |
FINERACT_BASIC_AUTH_TOKEN | API authentication token |
FINERACT_TENANT_ID | Tenant identifier (default: default ) |
Note: Java uses MIFOSX_
prefixed variables (e.g., MIFOSX_BASE_URL
).
Available Resources
The MCP server exposes these resources:
Core Resources
fineract://clients
List all clientsfineract://clients/{clientId}
Get details for a specific clientfineract://loans
List all loansfineract://loans/{loanId}
Get details for a specific loan
Tools
search_clients
Search clients by name/attributescreate_client
Create a new client (Node.js/Python only)update_loan_status
Update loan status (Java/Python only)
Building Native Executables (Java Only)
For Java (Quarkus), create a native executable:
Testing with MCP Inspector
- Start your MCP server (Python/Java/Node.js).
- Run the inspector:Copy
- Connect to the server using the
STDIO
transport.
Contributing
- Python: Modify
python/app.py
andserver.js
for new resources. - Java: Extend
src/main/java/org/mifos/community/ai/...
for new endpoints. - Node.js: Update
nodejs/src/server.js
and add Zod schemas for validation.
Contact
- Apache Fineract Community: https://community.apache.org/
- MCP Specification: https://modelcontextprotocol.org
Guides
- Java/Quarkus: Quarkus MCP Guide
- Node.js: Use
npm run inspect
for live reloading - Python: Run with
python app.py
and configure.env
Key Features:
- Standardized API access via
fineract://
URIs - MCP-compliant with STDIO/SSE transports
- Environment-agnostic configuration
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrate the MCP Server for Mifos X an Open Source Core Banking Solution for Financial Institutions. Useful for managing clients, loans, savings, shares, financial transactions and generating financial reports.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that enables interaction with Safe (formerly Gnosis Safe) smart contract wallets, allowing users to query transactions, get multisig details, and decode transaction data through natural language.Last updated -3JavaScriptMIT License
- -securityFlicense-qualityAn MCP server implementation that integrates with Angle One APIs to provide standardized access to financial market data, trading operations, and portfolio management.Last updated -Python
- -securityAlicense-qualityAn MCP server allowing Clients to interact with Xero Accounting SoftwareLast updated -1408TypeScriptMIT License
- -securityAlicense-qualityAn MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.Last updated -PythonMIT License