Mpesa Mcp

Name: Mpesa Mcp
Author: gabrielmahia

by gabrielmahiacommunityv0.1.2

This MCP server enables AI agents to trigger M-Pesa payments, check transaction statuses, send SMS, and top up airtime across various African telecom networks.

From the registry: M-Pesa + Africa's Talking MCP server — payments, SMS, airtime for AI agents in East Africa.

GitHub Repository

Install & configure

Prerequisites

required
M-Pesa Daraja credentials
Create a Safaricom Daraja app for M-Pesa credentials
https://developer.safaricom.co.ke
required
Africa's Talking account
For SMS and airtime tools
https://account.africastalking.com

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `mpesa-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **M-Pesa Daraja credentials** — Create a Safaricom Daraja app for M-Pesa credentials (https://developer.safaricom.co.ke)
- **Africa's Talking account** — For SMS and airtime tools (https://account.africastalking.com)

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["mpesa-mcp"]
- required environment variables:
  - `MPESA_CONSUMER_KEY`: M-Pesa Daraja consumer key (example: `<your-consumer-key>`)
  - `MPESA_CONSUMER_SECRET`: M-Pesa Daraja consumer secret (example: `<your-consumer-secret>`)
  - `MPESA_SHORTCODE`: M-Pesa shortcode (174379 for sandbox) (example: `174379`)
  - `MPESA_PASSKEY`: M-Pesa passkey (example: `<your-passkey>`)
  - `MPESA_CALLBACK_URL`: Public callback URL (example: `https://yourdomain.com/mpesa/callback`)
  - `AT_USERNAME`: Africa's Talking username (sandbox for testing) (example: `sandbox`)
  - `AT_API_KEY`: Africa's Talking API key (example: `<your-at-api-key>`)
- optional environment variables:
  - `MPESA_SANDBOX`: Use sandbox environment (example: `true`)

Note: East African fintech MCP — M-Pesa (Safaricom Daraja) payments plus Africa's Talking SMS/airtime.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: East African fintech MCP — M-Pesa (Safaricom Daraja) payments plus Africa's Talking SMS/airtime.

Tools (5)

mpesa_stk_push

Trigger STK Push payment prompt on customer's M-Pesa phone

mpesa_stk_query

Check status of an STK Push request

mpesa_transaction_status

Query any M-Pesa transaction by receipt number

sms_send

Send SMS to 1–1,000 recipients across African networks

airtime_send

Send airtime top-up to any subscriber (KES, NGN, GHS, UGX, etc.)

Environment variables

MPESA_CONSUMER_KEYrequiredYour M-Pesa consumer key

MPESA_CONSUMER_SECRETrequiredYour M-Pesa consumer secret

MPESA_SHORTCODErequiredM-Pesa sandbox test shortcode

MPESA_PASSKEYrequiredYour M-Pesa passkey

MPESA_CALLBACK_URLrequiredYour M-Pesa callback URL

AT_USERNAMErequiredYour Africa's Talking username

AT_API_KEYrequiredYour Africa's Talking API key

Packages

mpesa-mcp

pypiv0.1.2transport: stdio

Details

Language: Python
License: MIT
Released: Mar 22, 2026
Last commit: Aug 1, 2026
Registry name: io.github.gabrielmahia/mpesa-mcp

Related Servers

Edgartools

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

2.6k

edgar.tools SEC Intelligence

SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.