Metadata-Version: 2.4
Name: mkopo-mcp
Version: 0.1.5
Summary: MCP server for alternative credit scoring in Kenya — M-PESA-based behavioral signals
Author-email: Gabriel Mahia <contact@aikungfu.dev>
License: MIT
Project-URL: Homepage, https://github.com/gabrielmahia/mkopo-mcp
Project-URL: Repository, https://github.com/gabrielmahia/mkopo-mcp
Project-URL: Issues, https://github.com/gabrielmahia/mkopo-mcp/issues
Project-URL: Documentation, https://github.com/gabrielmahia/nairobi-stack
Project-URL: MCP Registry, https://registry.modelcontextprotocol.io
Project-URL: Datasets, https://huggingface.co/gmahia
Project-URL: Evaluation, https://github.com/gabrielmahia/kipimo
Keywords: mcp,credit,kenya,africa,mpesa,alternative-credit,fintech,mkopo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.0.0
Dynamic: license-file

# 💳 mkopo-mcp — Alternative Credit Scoring MCP Server
<!-- mcp-name: io.github.gabrielmahia/mkopo-mcp -->

[![mkopo-mcp Glama score](https://glama.ai/mcp/servers/gabrielmahia/mkopo-mcp/badges/score.svg)](https://glama.ai/mcp/servers/gabrielmahia/mkopo-mcp)
[![smithery badge](https://smithery.ai/badge/@gabrielmahia/mkopo-mcp)](https://smithery.ai/server/@gabrielmahia/mkopo-mcp)


---
**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

```bash
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`](https://github.com/gabrielmahia/africa-coord-bus) —
the coordination event bus that routes signals between domains automatically.

```bash
pip install africa-coord-bus
```

All servers: [pypi.org/user/gmahia](https://pypi.org/user/gmahia/)
Live demo: [coord-cascade-demo](https://github.com/gabrielmahia/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](docs/architecture/IP_POLICY.md). Security reports: see [SECURITY.md](SECURITY.md).

<!-- interconnect:v1 -->
## Part of the East Africa coordination stack

- **Install & run:** `pip install reli-cli && reli list` — the MCP servers on the [official MCP Registry](https://registry.modelcontextprotocol.io) under `io.github.gabrielmahia`
- **Evaluate any model on Swahili agent tasks:** [kipimo](https://github.com/gabrielmahia/kipimo) · [dataset](https://huggingface.co/datasets/gmahia/kipimo) · [leaderboard](https://huggingface.co/spaces/gmahia/kipimo-leaderboard)
- **Coordinate across servers:** [africa-coord-bus](https://pypi.org/project/africa-coord-bus/) — offline-first event bus with a built-in Kenya routing table
- **Datasets:** [huggingface.co/gmahia](https://huggingface.co/gmahia) · **Docs hub:** [nairobi-stack](https://github.com/gabrielmahia/nairobi-stack)

Model-agnostic by design: closed APIs, open-weight models, and small distilled models are all first-class citizens.
<!-- /interconnect:v1 -->

## 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** (as of 2026-10-10); it would add a right to an explanation and to human review of significant automated decisions such as a loan rejection, and commentators expect credit scoring to be treated as high-risk. 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.
