Afrimomo MCP Server

v0.0.2-beta.1

Model Context Protocol server enabling AI assistants like Claude to handle payment operations through natural language. 23 comprehensive tools for seamless payment management.

What is Model Context Protocol?

MCP is an open protocol that enables AI assistants to connect with external tools and data sources. The Afrimomo MCP server allows Claude Desktop to interact with African payment providers using natural language.

Instead of writing code, you can simply ask: "What's my PawaPay wallet balance?" or "Send a payout of 1000 MWK to account 123456"

Installation

# Global installation
npm install -g afrimomo-mcp

# Or use with npx (no installation required)
npx afrimomo-mcp

Claude Desktop Configuration

Add the following to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "afrimomo": {
      "command": "npx",
      "args": ["-y", "afrimomo-mcp"],
      "env": {
        "PAYCHANGU_SECRET_KEY": "your-paychangu-secret-key",
        "PAWAPAY_JWT": "your-pawapay-jwt-token",
        "ENVIRONMENT": "DEVELOPMENT"
      }
    }
  }
}

Important: After updating the config, fully quit and restart Claude Desktop to load the MCP server.

Available Tools (23 Total)

PayChangu Tools (11)

Payment & Transactions

  • • Initiate hosted checkout payment
  • • Verify transaction status
  • • Initiate direct charge
  • • Get transaction details

Bank Transfers

  • • Process bank transfer
  • • Get supported banks

Mobile Money & Payouts

  • • Get mobile operators
  • • Mobile money payout
  • • Bank payout
  • • Get payout details
  • • List all payouts

PawaPay Tools (12)

Deposits

  • • Request deposit
  • • Get deposit details
  • • Resend deposit callback

Payouts

  • • Send single payout
  • • Send bulk payout
  • • Get payout details

Refunds

  • • Create refund
  • • Get refund status

Wallet & Config

  • • Get all balances
  • • Get country balance
  • • Get active config
  • • Get availability

Usage Examples

Once configured in Claude Desktop, you can interact with payment providers through natural language:

Check Wallet Balances

"What are my PawaPay wallet balances?"

Returns balances for all supported countries

Verify Transaction

"Can you verify PayChangu transaction TX_12345?"

Verifies the transaction status and returns details

Request Deposit

"Request a PawaPay deposit of 100 ZMW from phone number 260971234567 using MTN Zambia"

Initiates a mobile money deposit request

Send Payout

"Send a PayChangu mobile money payout of 5000 MWK to 265991234567"

Processes a mobile money payout

Get Mobile Operators

"Show me all supported mobile money operators for PayChangu"

Lists all available mobile money operators

Getting API Credentials

PawaPay

  1. Create an account at PawaPay
  2. Complete onboarding and verification
  3. Generate an API token (JWT) from the dashboard
  4. Use sandbox tokens for testing

PayChangu

  1. Sign up at PayChangu
  2. Complete business verification
  3. Get your secret key from the merchant dashboard
  4. Use test credentials for sandbox environment

Troubleshooting

Tools not appearing in Claude

  • 1. Check that your claude_desktop_config.json is valid JSON
  • 2. Verify the file path to the config is correct
  • 3. Fully quit and restart Claude Desktop
  • 4. Check the Claude Desktop logs for errors

Authentication errors

  • 1. Verify your API credentials are correct
  • 2. Check that environment variables are properly set
  • 3. Ensure you're using the correct environment (sandbox vs production)
  • 4. Verify your account has the necessary permissions

Connection issues

  • 1. Check your internet connection
  • 2. Verify the payment provider services are operational
  • 3. Check for any API rate limiting

Used in Production

Vwaza Multimedia

Vwaza Multimedia uses Afrimomo MCP Server in production

Additional Resources