Каталог MCP
gabrielmahia/mpesa-mcp

gabrielmahia/mpesa-mcp

Name: gabrielmahia/mpesa-mcp
Availability: InStock
Author: gabrielmahia

MCP сервер для африканских платежных API: запускайте платежи M-Pesa, проверяйте статусы, отправляйте SMS и пополняйте воздух через 20+ сетей. Полезен разработчикам AI-агентов для финансовых операций в Восточной Африке.

README

23 инструмента

Версии

Установить сервер

mpesa-mcp

MCP server for East African fintech APIs — M-Pesa (Safaricom Daraja) and Africa's Talking

Give your AI agent the ability to trigger M-Pesa payments, check transaction status, send SMS, and top up airtime across 20+ African telecom networks.

Tested With

claude-sonnet-5  (recommended — call get_model_hint() for guidance)
claude-opus-4-8  (for highest-accuracy compliance reasoning)

Claude Sonnet 5 (released June 30, 2026) finishes multi-step M-PESA workflows without stopping short and self-corrects tool-call errors without prompting. Terminal-Bench score 80.4% vs Sonnet 4.6's 67.0% — the benchmark most analogous to payment agent work.

Why this exists

M-Pesa processes more transactions per day than PayPal does in Africa. Africa's Talking reaches users in 20+ countries on basic phones via SMS and USSD. Neither has an MCP server.

This means every AI agent built today — Claude, GPT, Gemini, or any MCP-compatible runtime — cannot trigger an M-Pesa payment or send a Kiswahili SMS without custom integration work.

Инструменты были проиндексированы: 11.09.2026

airtime_sendвнешний мир

Пополняет баланс абонентов MTN/Safaricom/Airtel/Vodafone. Используется для полевых поощрений НКО, вознаграждений за опросы, выплат агентам. Валюта сверяется с кодом страны получателя. Отправка суммы в KES на танзанийский номер отклоняется с указанием правильной валюты, вместо того чтобы молча пополнить счёт в неверной валюте. В режиме песочницы (AT_USERNAME=sandbox) реальное пополнение баланса не отправляется.

Отправить эфирное время

Параметры

amountstringобязательный
Amount as string e.g. '50'. Denominated in currency_code, NOT always KES.
currency_codestring
ISO currency: KES, TZS, UGX, RWF, NGN, GHS, ZAR, ETB, MWK, ZMW. MUST match the recipient's country — a mismatch is rejected, not silently sent.
phonestringобязательный
Recipient phone in E.164 format e.g. '+254712345678'

get_model_hint

Возвращает рекомендованную модель ИИ для использования инструментов mpesa-mcp. Вызывайте это первым при выборе модели для работы с mpesa-mcp.

Получает подсказку модели.

Параметры

Без параметров.

mpesa_account_balanceтолько чтениеидемпотентныйвнешний мир

Запрашивает текущий баланс бизнес-аккаунта M-Pesa (shortcode/till). Результат доставляется асинхронно в MPESA_RESULT_URL. Требуются MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

Баланс счета M-Pesa

Параметры

identifier_typestring
1=MSISDN, 2=Till, 4=Shortcode/Paybill
remarksstring
Query remarks

mpesa_b2b_express_checkoutвнешний мир

Запускает USSD Push на till — позволяет проводить платежи между мерчантами. Мерчант-получатель получает USSD-запрос для подтверждения платежа со своего till. Используется для оптовых платежей поставщикам между мерчантами Lipa Na M-PESA. Требует MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

B2B Express Checkout

Параметры

account_referencestringобязательный
Account reference for the transaction
amountintegerобязательный
Amount in KES
receiver_tillstringобязательный
Recipient till number
remarksstring
Remarks

mpesa_b2cвнешний мир

Выплата от бизнеса клиенту — перевод денег с короткого номера на телефон. Используется для зарплат, полевых стимулов НПО, агентского оборота, вознаграждений за опросы. Результат доставляется асинхронно на MPESA_RESULT_URL. Требует MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

M-Pesa B2C

Параметры

amountintegerобязательный
Amount in KES to send
command_idstring
SalaryPayment | BusinessPayment | PromotionPayment
occasionstring
Optional occasion label
phonestringобязательный
Recipient phone number (any Kenyan format)
remarksstring
Remarks (max 100 chars)

mpesa_bill_manager_cancelидемпотентныйвнешний мир

Отменить неоплаченный счёт Bill Manager.Клиент больше не сможет оплатить отменённый счёт.Используйте, когда заказ отменён или был создан дублирующий счёт.

Bill Manager - Отменить счёт

Параметры

external_referencestringобязательный
The externalReference used when creating the invoice

mpesa_bill_manager_invoiceвнешний мир

Создаёт счёт Bill Manager — клиент получает SMS со ссылкой на оплату. Он может оплатить напрямую через M-PESA, перейдя по ссылке или используя paybill. Возвращает идентификатор счёта. Используйте mpesa_bill_manager_cancel для аннулирования неоплаченных счетов.

Bill Manager — Создать счет

Параметры

account_refstring
Account reference for the payment
amountnumberобязательный
Invoice amount in KES
billing_refstringобязательный
Customer billing account reference
due_datestringобязательный
Payment due date YYYY-MM-DD
external_refstringобязательный
Your internal invoice/reference number
invoice_namestringобязательный
Invoice description shown to customer
phonestringобязательный
Customer phone to receive SMS notification

mpesa_bill_manager_optinидемпотентныйвнешний мир

Зарегистрируйте свой бизнес в M-PESA Bill Manager. Этот инструмент нужно вызвать один раз перед созданием счетов. После подключения клиенты смогут оплачивать ваши счета напрямую через M-PESA.

Bill Manager — Opt In

Параметры

callback_urlstring
Callback URL for Bill Manager events
emailstringобязательный
Business email for Bill Manager notifications
logo_urlstring
HTTPS URL to your business logo (PNG/JPG)

mpesa_business_buygoodsвнешний мир

Платёж с бизнес-короткого кода на номер терминала или покупки товаров. Требуются MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

Покупка товаров для бизнеса (B2B)

Параметры

amountintegerобязательный
Amount in KES
remarksstring
Transaction remarks
till_numberstringобязательный
Destination till number (Buy Goods)

mpesa_business_paybillвнешний мир

Оплачивает напрямую с бизнес-короткого кода на другой номер Paybill. Использует для выплат поставщикам, коммунальных счетов, межбизнес-переводов. Требует MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

Оплата счетов для бизнеса (B2B)

Параметры

account_referencestringобязательный
Account number at destination paybill
amountintegerобязательный
Amount in KES
receiver_paybillstringобязательный
Destination paybill shortcode
remarksstring
Transaction remarks

mpesa_business_pochiвнешний мир

Оплата с бизнес-шорткода на кошелёк Pochi la Biashara для микропредприятий. Используется для платежей поставщикам микропредприятий и расчётов в неформальном секторе. Требует MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

Business to Pochi la Biashara

Параметры

amountintegerобязательный
Amount in KES
phonestringобязательный
Pochi wallet owner phone number
remarksstring
Remarks

mpesa_dynamic_qrтолько чтениеидемпотентный

Генерирует динамический QR-код M-PESA для конкретной суммы платежа. Клиент сканирует QR через приложение M-PESA — сумма заполняется автоматически. Возвращает изображение QR-кода в кодировке base64. Используйте для чеков, счетов, экранов POS.

Динамический QR-код

Параметры

amountintegerобязательный
Amount in KES to encode in QR
merchant_namestringобязательный
Business/merchant name to display on QR
qr_sizeinteger
QR image size in pixels (300-1000)
ref_nostringобязательный
Transaction reference number
trx_codestring
BG=Buy Goods, PB=Paybill, WA=Wallet, SM=Send Money, SB=Lipa Shortcode

mpesa_imsi_queryтолько чтениеидемпотентныйвнешний мир

Проверяет номер Safaricom — возвращает дату регистрации, возраст SIM, последнюю замену и хешированный IMSI. Усиленный сигнал KYC/AML для соблюдения требований финансовых услуг. У старых SIM-карт без недавних замен риск мошенничества ниже. Возвращает данные, пригодные для оценки риска, без раскрытия сырого IMSI.

IMSI Query - Phone Verification

Параметры

phonestringобязательный
Phone number to verify

mpesa_pull_transactionsтолько чтениеидемпотентныйвнешний мир

Получить все C2B-транзакции для сверки за указанный период. Возвращает платежи клиентов на ваш короткий номер для аудита и сверки. Максимальный диапазон — 48 часов за один вызов. Максимум 10 000 записей за один вызов.

Pull C2B Transactions

Параметры

end_datestringобязательный
End date YYYY-MM-DD HH:MM:SS
offsetinteger
Pagination offset (0-based)
start_datestringобязательный
Start date YYYY-MM-DD HH:MM:SS

mpesa_query_org_infoтолько чтениеидемпотентныйвнешний мир

Проверяет shortcode — возвращает зарегистрированное имя и тип тарифа. Используйте перед отправкой B2B-платежей, чтобы убедиться, что целевой shortcode правильный. Предотвращает случайные платежи на неверные номера Paybill.

Query Org Info

Параметры

shortcodestringобязательный
Shortcode to validate (paybill or till number)

mpesa_ratiba_createвнешний мир

Создает постоянное поручение M-PESA Ratiba - автоматические регулярные платежи.Клиент авторизует один раз; платежи выполняются автоматически по расписанию.Идеально подходит для подписок, сбора арендной платы, погашения кредитов, взносов в SACCO.Возвращает ID постоянного поручения для управления или отмены позже.

M-PESA Ratiba - Создать регулярный платёж

Параметры

account_refstringобязательный
Account reference for each payment
amountintegerобязательный
Amount in KES per payment
descriptionstring
Standing order description
end_datestringобязательный
End date YYYYMMDD
frequencystring
1=One-Off 2=Daily 3=Weekly 4=Monthly 5=Bi-Monthly 6=Quarterly 7=Half-Year 8=Annually
phonestringобязательный
Customer phone number
standing_order_namestringобязательный
Name for the standing order
start_datestringобязательный
Start date YYYYMMDD

mpesa_reversalвнешний мир

Отменить ошибочную транзакцию M-Pesa. Используйте, когда платеж отправлен на неверный номер или неверную сумму. Требуются MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL. Результат доставляется асинхронно на MPESA_RESULT_URL.

Отмена M-Pesa

Параметры

amountintegerобязательный
Amount to reverse in KES
remarksstring
Reason for reversal
transaction_idstringобязательный
M-Pesa receipt to reverse e.g. QKL8XXXXXX

mpesa_sim_swap_queryтолько чтениеидемпотентныйвнешний мир

Проверяет, была ли недавно заменена SIM-карта для номера телефона. Критический сигнал предотвращения мошенничества — замена SIM-карты часто предшествует взлому учётных записей. Используйте перед крупными B2C-выплатами, чтобы проверить стабильность личности получателя. Возвращает статус замены и дату последней замены.

Запрос SIM Swap

Параметры

phonestringобязательный
Phone number to check for SIM swap activity

mpesa_stk_pushвнешний мир

Запускает M-Pesa STK Push — отправляет запрос на оплату на телефон клиента. Клиент вводит PIN-код M-PESA для завершения платежа. Возвращает CheckoutRequestID; опрашивайте mpesa_stk_query через 10-30 секунд.

M-Pesa STK Push

Параметры

account_refstringобязательный
Account reference shown to customer on phone (max 12 chars)
amountintegerобязательный
Amount in KES (whole number, min 1, max 150000)
descriptionstring
Transaction description (max 13 chars)
phonestringобязательный
Customer phone (any Kenyan format: +254..., 07..., 254...)

mpesa_stk_queryтолько чтениеидемпотентныйвнешний мир

Проверяет статус STK Push. Опрашивает через 10-30 секунд после mpesa_stk_push. ResultCode 0 = успех, 1032 = отменён, 1037 = истекло время ожидания. ВАЖНО: STK Push от Daraja имеет окно ~60 секунд, и callback НЕ гарантирован, если пользователь закроет запрос. Опрашивайте этот инструмент 2-3 раза в течение этого окна, прежде чем считать молчание ошибкой. Один пустой ответ не означает, что платёж не прошёл.

M-Pesa STK Query

Параметры

checkout_request_idstringобязательный
CheckoutRequestID from mpesa_stk_push response

mpesa_tax_remittanceвнешний мир

Переводит налог напрямую с бизнес-счета M-PESA в Kenya Revenue Authority. Предоставьте номер регистрации платежа KRA (PRN) в качестве account_reference. Короткий код KRA: 572572. Требуются MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL.

Перечисление налогов в KRA

Параметры

account_referencestringобязательный
KRA Payment Registration Number (PRN)
amountintegerобязательный
Tax amount in KES
remarksstring
Remittance remarks

mpesa_transaction_statusтолько чтениеидемпотентныйвнешний мир

Запросить статус любой транзакции M-Pesa по номеру квитанции. Требует MPESA_INITIATOR_NAME и MPESA_SECURITY_CREDENTIAL. Результат доставляется асинхронно на MPESA_RESULT_URL.

Статус транзакции M-Pesa

Параметры

transaction_idstringобязательный
M-Pesa receipt number e.g. QKL8XXXXXX

sms_sendвнешний мир

Отправляет SMS 1-1000 получателям через Africa's Talking. Работает в Кении, Нигерии, Гане, Танзании, Уганде, Руанде и ещё более 15 странах. Возвращает статус по каждому получателю и разбивку стоимости.

Отправить SMS

Параметры

messagestringобязательный
SMS message text. Unicode supported (Kiswahili etc.)
recipientsstring[]обязательный
Phone numbers in E.164 format e.g. ['+254712345678']
sender_idstring
Optional pre-registered alphanumeric sender ID

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mpesa-mcp"
  ],
  "env": {
    "MPESA_CONSUMER_KEY": "your_key",
    "MPESA_CONSUMER_SECRET": "your_secret",
    "MPESA_SHORTCODE": "174379",
    "MPESA_PASSKEY": "your_passkey",
    "MPESA_CALLBACK_URL": "https://yourdomain.com/mpesa/callback",
    "MPESA_SANDBOX": "true",
    "AT_USERNAME": "sandbox",
    "AT_API_KEY": "your_at_key"
  }
}