openMF/mcp-mifosx-self-service

MifosX Self Service MCP is a Model Context Protocol (MCP) server built using FastMCP (Python).
It exposes a set of AI-callable tools that allow MCP-compatible clients (such as Claude Desktop or DeepChat) to securely interact with the Apache Fineract / MifosX Self-Service APIs.
This project enables AI-driven banking workflows such as authentication, account access, beneficiary management, loans, savings, and transfers — while keeping all sensitive logic on the server side.
Features
* Register new self-service users.
* Confirm user registration.
* User login and authentication.
* Manage client information.
* Manage beneficiaries (add, list, update, delete).
* View client accounts and transactions.
* Manage loans (view products, applications, transactions, charges).
* Manage savings accounts (products, applications, transactions, charges).
* Manage guarantors for loans.
* Manage share accounts and products.
* Register for push notifications.
* Perform third-party account transfers.
Architecture
The MCP server acts as a secure bridge between your AI client and the Mifos/Fineract backend.
Project Structure
Installation
1. **Clone the repository:**
2. **Create and activate a virtual environment (recommended):**
3. **Install the required dependencies:**
Configuration
The application connects to a Fineract API. Use environment variables (or a .env file) for customization:
| Variable | Description | Default |
|----------|-------------|---------|
| MIFOS_BASE_URL | Base URL of Fineract instance | https://tt.mifos.community |
| MIFOS_TENANT | Tenant identifier | default |
For authentication, the application uses default credentials (maria/password), but these can be overridden using environment variables for better security and flexibility.
Running with Docker
The project includes Docker support for easy deployment:
Using with Claude Desktop (MCP)
* In Claude Desktop → Settings → Developer → Local MCP servers → Edit Config, add:
Restart Claude Desktop after saving.
Running the Server
To run the MCP server, execute the following command from the project's root directory:
Example Usage (Natural Language) on Claude
Once the MCP server is connected, Claude can invoke the available tools automatically.
You can paste the following prompts in Claude Desktop to verify that your configuration is working correctly:
- Login using username maria and password password
- Get my client information
- Show my client accounts
- List my beneficiaries
- Get my loan accounts
- Show my savings accounts
If these commands return valid responses, your MCP server is successfully connected and operational.
Available MCP Tools
The MCP server exposes the following AI-callable tools.
Each tool internally maps to a Fineract self-service API call.
These tools are invoked by MCP-compatible AI clients, not directly via HTTP.
Authentication
| Method | MCP Tool Name | Description |
|--------|----------------------------|------------------------------------------|
| POST | register_self_service | Register a new self-service user |
| POST | confirm_registration | Confirm user registration with token |
| POST | login_self_service | Authenticate a self-service user |
Client & Accounts
| Method | MCP Tool Name | Description |
|--------|----------------------------|------------------------------------------|
| GET | get_client_info | Retrieve client information |