Skip to main content
Glama
mcp-african-markets

mcp-african-markets

by mutheejj

πŸ’³ mcp-african-markets

MCP servers for African markets β€” agentic tooling for payments, reconciliation, and public data.

CI License: MIT Node Sponsor

M-Pesa Β· Mobile-money reconciliation Β· County data Β· Built agent-first


Why

African fintech runs on M-Pesa, bank rails, and a patchwork of public portals β€” but almost none of it speaks to AI agents. If your agent can't call Daraja or reconcile a till, it can't do real work for millions of users.

mcp-african-markets ships focused Model Context Protocol servers so any MCP-aware agent gets first-class African-market tools.

Related MCP server: PayLink MCP Server

Servers

Server

Status

What your agent can do

daraja

🚧 in progress

Initiate B2C/B2B payouts, query transaction status, validate phone numbers

reconcile

🚧 in progress

Match M-Pesa statements against ledger CSVs, surface discrepancies

county-data

πŸ“‹ planned

Structured lookups for county public data

kra

πŸ“‹ planned

PIN validation helpers and filing-status lookups

Quickstart

npx mcp-african-markets --server daraja

Wire it into any MCP client:

{
  "mcpServers": {
    "african-markets": {
      "command": "npx",
      "args": ["-y", "mcp-african-markets", "--server", "daraja"],
      "env": {
        "DARAJA_CONSUMER_KEY": "your-key",
        "DARAJA_CONSUMER_SECRET": "your-secret",
        "DARAJA_ENV": "sandbox"
      }
    }
  }
}

Defaults to sandbox. Production requires explicit opt-in (DARAJA_ENV=production) β€” agents should not move real money by accident.

Design principles

  1. Sandbox by default β€” money-moving tools are opt-in, loudly

  2. Read-only where possible β€” reconciliation and lookups never mutate state

  3. Idempotency keys everywhere β€” agents retry; payouts must not double-fire

  4. Local-first β€” works offline against cached statements

Status

🚧 v0.x β€” early development. The daraja server skeleton and sandbox auth flow are landing first.

Roadmap

  • Project scaffold + MCP server template

  • daraja: sandbox auth + STK push + transaction status

  • reconcile: statement parser + fuzzy matcher

  • county-data: first datasets

  • kra: PIN validation helpers

  • Example agent walkthroughs

Who is this for

  • Fintech teams building agent-powered ops on African rails

  • Hackathon teams who want working payments tools on day one

  • Developers who believe agents should work everywhere, not just in Silicon Valley

Contributing

PRs welcome β€” new MCP servers, dataset contributions, and sandbox fixtures especially.

πŸ’– Support

I build tools for the multi-agent era in the open. If this saves you time, consider sponsoring.

MIT Β© John Muthee

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server for East African fintech APIs β€” trigger M-Pesa STK Push payments, check transaction status, send SMS to 20+ African networks, and top up airtime via Africa's Talking.
      5
      213 PyPI
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Open-source MCP server that streamlines payment integration for AI agents and financial apps in Africa, providing unified tools for providers like M-Pesa.
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables interaction with Safaricom M-Pesa Daraja 3.0 API, covering payments, disbursements, treasury, and fraud checks, with a built-in simulator for testing without credentials.
      25
      19 npm
      MIT