Skip to main content

MCP server for alternative credit scoring in Kenya — M-PESA-based behavioral signals

Project description

💳 mkopo-mcp — Alternative Credit Scoring MCP Server

mkopo-mcp Glama score smithery badge


Compatible with claude-sonnet-5 (released 2026-06-30) — Anthropic's most agentic Sonnet yet. Runs multi-step tool chains end-to-end without stopping short. 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

Tool What it does
alternative_credit_score Score from M-PESA behavioural signals (300–850 scale)
mpesa_creditworthiness Analyse inflow/outflow patterns for loan capacity
credit_report_summary Generate structured report like a loan officer would review
loan_eligibility Match to appropriate Kenya lender types
credit_improvement_tips Personalised 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 one of 32 tools in 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 32 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mkopo_mcp-0.1.3.tar.gz (12.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkopo_mcp-0.1.3-py3-none-any.whl (11.0 kB view details)

Uploaded Python 3

File details

Details for the file mkopo_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: mkopo_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 12.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mkopo_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 3aadd0b4400246cc64f5fe304592a84259b553af711ed6866faa64b8442bbeea
MD5 31f2b33565baa6b003beaa9125fbe97c
BLAKE2b-256 91afd3cc711d882afac66e45c0a3946d28bd673ebd48ecb42f39c91c4f4345cd

See more details on using hashes here.

File details

Details for the file mkopo_mcp-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: mkopo_mcp-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 11.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mkopo_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 85dcda9b092fb184191d67ad1487d1d5e65f20aed3b30485fbd4e20c4a980d2a
MD5 93cd143581a7500d592ec29c9d1a9039
BLAKE2b-256 817b053043ae319d30c5b41b730960de8defa0076e91a8caf18905b430637b32

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page