# Mkopo MCP

> Mkopo MCP is an open-source MCP server for finance and payments. MCP server that scores credit from M-PESA-style mobile money signals, demo only. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/gabrielmahia/mkopo-mcp
- **MCP Registry name:** io.github.gabrielmahia/mkopo-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server is a demonstration of alternative credit scoring for people in Kenya who transact mostly through mobile money and have no formal credit file. Instead of a bureau record, it reads behavioural signals such as income deposit regularity, utility payment habits, savings activity and short-term borrowing usage, and turns them into a score on a 300 to 850 scale.

The README says the tools produce synthetic demonstration results rather than credit decisions, and that the project is not a Credit Reference Bureau product. Input is meant to be synthetic; the README asks users not to pass real names or ID numbers. Nothing is stored between calls.

Besides scoring, the toolset includes a loan-officer style summary, lender-type matching, improvement suggestions and a live Kenya macro indicator tool that pulls inflation and lending rates from the IMF and World Bank. The package is MIT licensed and runs over stdio for any MCP client.

## Features

- **Alternative credit score:** Produces a 300 to 850 score from mobile money behavioural signals.
- **Cash flow analysis:** Reviews inflow and outflow patterns to estimate loan capacity.
- **Structured credit report:** Generates a summary laid out the way a loan officer would review it.
- **Lender type matching:** Suggests generic Kenyan lender categories that fit a given profile.
- **Live macro indicators:** Fetches Kenya inflation and lending and deposit rates with source attribution.

## Good for

- Prototyping an agent that explains how mobile money history could inform credit scoring
- Testing credit-related tool calls in an MCP client without real borrower data
- Teaching or researching alternative credit scoring in East African markets
- Pulling current Kenya inflation and lending rate figures into an agent workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add mkopo-mcp -- uvx mkopo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mkopo-mcp": {
      "command": "uvx",
      "args": [
        "mkopo-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mkopo-mcp": {
      "command": "uvx",
      "args": [
        "mkopo-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mkopo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mkopo-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mkopo-mcp": {
      "command": "uvx",
      "args": [
        "mkopo-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mkopo-mcp": {
      "command": "uvx",
      "args": [
        "mkopo-mcp"
      ]
    }
  }
}
```

## Tools

- `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
- `kenya_macro_indicators`: Kenya inflation and lending and deposit rates

## FAQ

### Is this a real credit bureau product?

No. The README states it is not a Credit Reference Bureau product and that its outputs are synthetic demonstration results, not credit decisions.

### Does it store the data it receives?

The registry entry describes the server as storing nothing.

### How is it installed?

The package is published on PyPI as mkopo-mcp and runs on stdio. The README says it is installed with pip and started with the mkopo-mcp command.

### What license is it under?

The README says it is MIT licensed.

### Is Mkopo MCP free?

Yes. Mkopo MCP is open source, so you can use and self-host it for free.

### How do I add Mkopo MCP to Claude Code?

Run this command in your terminal: claude mcp add mkopo-mcp -- uvx mkopo-mcp

### What are the best alternatives to Mkopo MCP?

The closest alternatives to Mkopo MCP are Banking Assistant (Metabind demo), Finance Fintech Mcp, BankRegReports, Crypto Market Data and TreasuryOS.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Banking Assistant (Metabind demo)](https://ai-powered.com/mcp/banking-assistant-metabind-demo): Banking Assistant (Metabind demo) is a freemium MCP server for finance and payments.
- [Finance Fintech Mcp](https://ai-powered.com/mcp/finance-fintech-mcp): Finance Fintech Mcp is a freemium MCP server for finance and payments.
- [BankRegReports](https://ai-powered.com/mcp/bankregreports): BankRegReports is a freemium MCP server for finance and payments.
- [Crypto Market Data](https://ai-powered.com/mcp/crypto-market-data): Crypto Market Data is an open-source MCP server for finance and payments.
- [TreasuryOS](https://ai-powered.com/mcp/treasuryos): TreasuryOS is an open-source MCP server for finance and payments.
- [PaisaFinder](https://ai-powered.com/mcp/paisafinder): PaisaFinder is a free MCP server for finance and payments.
- [Debt Payoff MCP](https://ai-powered.com/mcp/debt-payoff-mcp): Debt Payoff MCP is an open-source MCP server for finance and payments.
- [TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures](https://ai-powered.com/mcp/tradingcalc-mcp-options-forex-risk-stats-prediction-markets): TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/mkopo-mcp
