Skip to main content
Glama
kenyaclaw

Africa Payments MCP

by kenyaclaw
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🌍 Africa Payments MCP

The missing piece for African fintech. One MCP server. Every major African payment provider. Natural language payments.

CI Security codecov npm version Downloads License: MIT Built by Africans

✨ What if accepting payments was as easy as sending a message?

# "Send KES 5,000 to Mary via M-Pesa"
# "Request $100 from a customer in Nigeria"  
# "Check if that MTN MoMo payment came through"
# "Process a refund for order #12345"

No more wrestling with 5 different APIs. No more juggling documentation.
Just natural language that works across M-Pesa, Paystack, MTN MoMo, and more.

🎬 See It In Action

Demo with Claude

Demo with Cursor

Claude Demo

Cursor Demo

💡 Why Africa Payments MCP?

The Problem 😤

Africa has the world's most innovative payment systems—M-Pesa, Paystack, Flutterwave, MTN MoMo, Chipper Cash—but integrating them is a nightmare:

  • 🔀 Fragmented APIs: M-Pesa uses SOAP. Paystack uses REST. MTN MoMo uses something entirely different.

  • 📚 Scattered Documentation: Hours spent hunting for the right docs

  • 🔧 Different Auth Methods: API keys, OAuth, basic auth—each one unique

  • 🐛 Edge Cases Everywhere: Each provider has quirks that break your code

  • ⏱️ Weeks of Integration Time: Before you process a single payment

The Solution 🎯

One MCP server. Every provider. Natural language.

// Instead of this...
const mpesa = new MpesaAPI({ consumerKey, consumerSecret, passkey });
await mpesa.authenticate();
const result = await mpesa.stkPush({ phone, amount, accountRef });

// Just say this:
"Send KES 5,000 to 254712345678 via M-Pesa"

The Impact 🚀

  • ⚡ Ship in hours, not weeks — Your first payment working today

  • 🧠 AI-native from day one — Built for the era of AI agents

  • 🌍 Truly Pan-African — One integration covers the continent

  • 🔓 Open Source — MIT licensed, community-driven

  • 🛠️ Developer-First — Built by Africans who understand the pain

🚀 Quick Start

One-Line Installer (Recommended)

curl -fsSL https://raw.githubusercontent.com/kenyaclaw/africa-payments-mcp/main/scripts/install.sh | bash

Or with wget:

wget -qO- https://raw.githubusercontent.com/kenyaclaw/africa-payments-mcp/main/scripts/install.sh | bash

Manual Installation

1. Install

npm install -g @kenyaclaw/africa-payments-mcp

2. Configure

Interactive wizard (recommended):

africa-payments-mcp init
# Beautiful interactive setup with emoji and progress indicators

Auto-detect existing credentials:

africa-payments-mcp detect --output config.json
# Automatically finds MPESA_*, PAYSTACK_* env vars and config files

3. Connect to Your AI

Add to your MCP client configuration:

{
  "mcpServers": {
    "africa-payments": {
      "command": "africa-payments-mcp",
      "env": {
        "MPESA_CONSUMER_KEY": "your_key",
        "PAYSTACK_SECRET_KEY": "your_key"
      }
    }
  }
}

4. Start Accepting Payments

Open Claude, ChatGPT, Cursor, or any MCP client and just ask:

"Send KES 5,000 to Mary via M-Pesa"

🐳 Docker Quick Start

Run with Docker (no Node.js installation required):

# Pull the latest image
docker pull kenyaclaw/africa-payments-mcp:latest

# Run with a config file
docker run -v $(pwd)/config.json:/app/config/config.json \
  kenyaclaw/africa-payments-mcp:latest

# Or run with environment variables
docker run -e MPESA_CONSUMER_KEY=xxx \
  -e MPESA_CONSUMER_SECRET=xxx \
  -e PAYSTACK_SECRET_KEY=xxx \
  kenyaclaw/africa-payments-mcp:latest

Docker Compose

version: '3.8'
services:
  africa-payments:
    image: kenyaclaw/africa-payments-mcp:latest
    volumes:
      - ./config.json:/app/config/config.json:ro
    environment:
      - NODE_ENV=production
    ports:
      - "3000:3000"  # For webhook support
    restart: unless-stopped

🔌 Supported Providers

Provider

Countries

Status

Features

M-Pesa

🇰🇪 Kenya, 🇹🇿 Tanzania, 🇲🇿 Mozambique, 🇨🇩 DRC, 🇪🇬 Egypt

✅ Ready

STK Push, B2C, B2B, C2B, Reversal

Paystack

🇳🇬 Nigeria, 🇬🇭 Ghana, 🇿🇦 South Africa, +4 more

✅ Ready

Cards, Bank Transfer, Mobile Money

MTN MoMo

🇳🇬 Nigeria, 🇬🇭 Ghana, 🇺🇬 Uganda, +12 more

✅ Ready

Collections, Disbursements, Remittances

Flutterwave

🇳🇬 Nigeria, 🇰🇪 Kenya, 🇿🇦 South Africa, +30 more

🚧 Beta

Cards, Mobile Money, Bank Transfer

Chipper Cash

🇳🇬 Nigeria, 🇬🇭 Ghana, 🇰🇪 Kenya, +7 more

🚧 Beta

P2P Transfers, Payments

💡 Want to add a provider? See our contribution guide

📖 Documentation

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Your AI Agent                             │
│              (Claude, ChatGPT, Cursor, etc.)                │
└─────────────────────┬───────────────────────────────────────┘
                      │ MCP Protocol
┌─────────────────────▼───────────────────────────────────────┐
│              Africa Payments MCP Server                      │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│  │   M-Pesa    │ │  Paystack   │ │     MTN MoMo            │ │
│  │   Adapter   │ │   Adapter   │ │     Adapter             │ │
│  └─────────────┘ └─────────────┘ └─────────────────────────┘ │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│  │ Flutterwave │ │ ChipperCash │ │    More Coming...       │ │
│  │   Adapter   │ │   Adapter   │ │                         │ │
│  └─────────────┘ └─────────────┘ └─────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

🌟 What Developers Are Saying

"Integrated M-Pesa in 10 minutes. Took me 3 weeks the old way."
— David O., Fintech Developer, Lagos

"Finally, payments that work the way I think about them."
— Grace W., Startup Founder, Nairobi

"The USB-C of African payments. One connection, everything works."
— Kofi A., Full Stack Engineer, Accra

🤝 Contributing

We built this for Africa's developers. Help us make it better:

  1. 🍴 Fork the repo

  2. 🌿 Create your branch (git checkout -b feature/amazing-feature)

  3. 💻 Make your changes

  4. ✅ Add tests

  5. 📝 Update documentation

  6. 🔀 Submit a PR

Read our Contributing Guide

📜 License

MIT License — use it, modify it, build the future of African fintech.

💬 Join the Community

🚀 Launch Materials

Ready to launch? Check out our complete launch kit: 📋 LAUNCH.md - Twitter, HN, Dev.to, LinkedIn, Product Hunt templates

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kenyaclaw/africa-payments-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server