English Français العربية

io.github.gabrielmahia/mkopo-mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.gabrielmahia/mkopo-mcp؟

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

كيف أثبّت io.github.gabrielmahia/mkopo-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add mkopo-mcp -- uvx mkopo-mcp==0.1.10. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gabrielmahia/mkopo-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.gabrielmahia/mkopo-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.gabrielmahia/mkopo-mcp؟

ينشره gabrielmahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.