English Français العربية

io.github.gabrielmahia/mkopo-mcp

Official registry Other

Demo alternative credit scoring from M-PESA signals. Not a CRB product; synthetic, nothing stored.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mkopo-mcp
Claude Code 
claude mcp add mkopo-mcp -- uvx mkopo-mcp==0.1.10
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mkopo-mcp": {
            "command": "uvx",
            "args": [
                "mkopo-mcp==0.1.10"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 💳 mkopo-mcp — Alternative Credit Scoring MCP Server
  2. The Structural Problem
  3. Tools
  4. Quick Start
  5. Research Basis
  6. Part of the East Africa Coordination Stack
  7. IP & Collaboration
  8. Part of the East Africa coordination stack
  9. Demonstration only, and Kenya's rules on automated decisions

💳 mkopo-mcp — Alternative Credit Scoring MCP Server

Install: pip install mkopo-mcp · Use with any MCP client.

Most East Africans transacting heavily on mobile money have no formal credit file — the data exists in M-PESA history, but no scoring model reads it as an agent-callable tool.

70%+ of Kenyan adults are "credit invisible" — no formal credit history means no access to capital. M-PESA is a de facto financial history record that predicts repayment behaviour. mkopo-mcp makes that intelligence accessible to AI agents.

The Structural Problem

In mature economies, credit bureaus have 30+ years of credit card, mortgage, and auto loan data per person. That data machine took 50 years to build. In Kenya, most people's financial lives happen in cash and mobile money — invisible to formal credit systems.

M-PESA is the credit bureau that doesn't know it is one.

  • Regular income deposits → income stability
  • Utility payment regularity → discipline signal
  • Savings behaviour (M-Shwari, chama) → future orientation
  • Fuliza usage ratio → short-term distress indicator
  • Business Paybill receipts → verifiable commercial activity

Tools

ToolWhat it does
alternative_credit_scoreScore from M-PESA behavioural signals (300–850 scale)
mpesa_creditworthinessAnalyse inflow/outflow patterns for loan capacity
credit_report_summaryGenerate structured report like a loan officer would review
loan_eligibilityMatch to appropriate Kenya lender types
credit_improvement_tipsPersonalised steps to improve credit tier

Quick Start

pip install mkopo-mcp       # coming soon to PyPI
mkopo-mcp                   # starts on stdio

Research Basis

  • World Bank "Expanding Access to Finance" (2022)
  • Breza & Kinnan "Measuring the Equilibrium Impacts of Credit" (2021)
  • CBK Prudential Guidelines (2022)
  • Kenya CRB Act (Cap. 44A)

⚠️ DEMO data — not a real CRB product. Consult Metropol or CRB Africa for official reports.

© 2026 Gabriel Mahia / AI Kung Fu LLC · MIT License

Part of the East Africa Coordination Stack

This MCP server is part of the Kenya coordination infrastructure. Connect it to africa-coord-bus — the coordination event bus that routes signals between domains automatically.

pip install africa-coord-bus

All servers: pypi.org/user/gmahia Live demo: coord-cascade-demo

IP & Collaboration

MIT licensed. Feedback via GitHub Issues only — pull requests are not accepted. Demo data is labeled DEMO and is not suitable for operational decisions. Full policy: docs/architecture/IP_POLICY.md. Security reports: see SECURITY.md.

Part of the East Africa coordination stack

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.

Demonstration only, and Kenya's rules on automated decisions

These tools produce synthetic demonstration results, not credit decisions, and they are not a Credit Reference Bureau product. Do not pass a real person's name or ID number to them.

If you build something real on a score like this, note the law: in Kenya the Data Protection Act 2019 is in force, including its provisions on decisions made solely by automated processing (section 35). The Artificial Intelligence Bill 2026 is a Senate bill and is not law: a Senate committee recommended abandoning it in October 2026, so as of 2026-10-23 Kenya has no dedicated AI law and the Data Protection Act is what applies. The bill would have added a right to an explanation and to human review of significant automated decisions such as a loan rejection, and commentators expected credit scoring to be treated as high-risk under such a law. Every scoring answer from this server carries an automated_decision_notice saying so. The lender examples are generic lender types, not named companies: an earlier version listed real lenders by tier, which this synthetic score cannot support.

Frequently asked questions

What is io.github.gabrielmahia/mkopo-mcp?

Demo alternative credit scoring from M-PESA signals. Not a CRB product; synthetic, nothing stored.

How do I install io.github.gabrielmahia/mkopo-mcp?

It runs on your machine. In Claude Code: claude mcp add mkopo-mcp -- uvx mkopo-mcp==0.1.10. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.gabrielmahia/mkopo-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.gabrielmahia/mkopo-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.gabrielmahia/mkopo-mcp?

It is published by gabrielmahia. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.