mcp-mifosx

Official
by openMF

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:

npx @modelcontextprotocol/inspector

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:

  1. Install dependencies:
    pip install mcp[cli] uv flask

    Note for zsh users: If you're using zsh, be sure to quote extras to avoid shell expansion errors:

    pip install 'mcp[cli]' uv flask
  2. Run the server:
    mcp dev app.py
Java (Quarkus)

Prerequisites: JDK 17+, Maven

Steps:

  1. Configure environment variables in your shell or IDE:
    export MIFOSX_BASE_URL="https://your-fineract-instance" export MIFOSX_BASIC_AUTH_TOKEN="your_api_token" export MIFOS_TENANT_ID="default"
  2. Run via JBang (for quick execution):
    jbang --quiet org.mifos.community.ai:mcp-server:1.0.0-SNAPSHOT:runner
  3. (Optional) Build a native executable:
    ./mvnw package -Dnative ./target/mcp-server-1.0.0-SNAPSHOT-runner
Node.js

Prerequisites: Node.js 16+, npm

Steps:

  1. Install dependencies:
    cd nodejs && npm install
  2. Configure environment variables in .env:
    cp .env.example .env
  3. Run the server:
    npm run dev
  4. Test with the built-in inspect script:
    npm run inspect

Configuration

All implementations require the following environment variables:

VariableDescription
FINERACT_BASE_URLBase URL of your Fineract instance
FINERACT_BASIC_AUTH_TOKENAPI authentication token
FINERACT_TENANT_IDTenant 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 clients
  • fineract://clients/{clientId}
    Get details for a specific client
  • fineract://loans
    List all loans
  • fineract://loans/{loanId}
    Get details for a specific loan

Tools

  • search_clients
    Search clients by name/attributes
  • create_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:

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

Testing with MCP Inspector

  1. Start your MCP server (Python/Java/Node.js).
  2. Run the inspector:
    npx @modelcontextprotocol/inspector
  3. Connect to the server using the STDIO transport.

Contributing

  • Python: Modify python/app.py and server.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


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
-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. MCP Developer Tools
    1. Getting Started
      1. 1. Choose Your Implementation
    2. Configuration
      1. Available Resources
        1. Core Resources
        2. Tools
      2. Building Native Executables (Java Only)
        1. Testing with MCP Inspector
          1. Contributing
            1. Contact
              1. Guides
                1. Key Features:

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                An 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 -
                3
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                An 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
              • -
                security
                A
                license
                -
                quality
                An MCP server allowing Clients to interact with Xero Accounting Software
                Last updated -
                140
                8
                TypeScript
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
                Last updated -
                Python
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              ID: v2j0vus1er