💳 mcp-african-markets

MCP servers for African markets — agentic tooling for payments, reconciliation, and public data.

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: KenyaMCPServer

Servers

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