gabrielmahia/mpesa-mcp

gabrielmahia/mpesa-mcp

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

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.

Tests PyPI License: MIT Glama Score smithery badge Glama NSA MCP Compliant

mpesa-mcp MCP server

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.

airtime_sendвнешний мир

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

Send Airtime

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

Параметры

  • phonestringобязательный

    Recipient phone in E.164 format e.g. '+254712345678'

  • amountstringобязательный

    Amount as string e.g. '50' (KES 50). Min KES 10 in production.

  • currency_codestring

    ISO currency: KES, NGN, GHS, UGX, TZS, RWF, ZAR

get_model_hint

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

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

Параметры

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

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

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

M-Pesa Account Balance

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

Параметры

  • 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

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

Параметры

  • receiver_tillstringобязательный

    Recipient till number

  • amountintegerобязательный

    Amount in KES

  • account_referencestringобязательный

    Account reference for the transaction

  • remarksstring

    Remarks

mpesa_b2cвнешний мир

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

M-Pesa B2C

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

Параметры

  • phonestringобязательный

    Recipient phone number (any Kenyan format)

  • amountintegerобязательный

    Amount in KES to send

  • command_idstring

    SalaryPayment | BusinessPayment | PromotionPayment

  • remarksstring

    Remarks (max 100 chars)

  • occasionstring

    Optional occasion label

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

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

Bill Manager — Cancel Invoice

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

Параметры

  • external_referencestringобязательный

    The externalReference used when creating the invoice

mpesa_bill_manager_invoiceвнешний мир

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

Bill Manager — Create Invoice

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

Параметры

  • external_refstringобязательный

    Your internal invoice/reference number

  • billing_refstringобязательный

    Customer billing account reference

  • invoice_namestringобязательный

    Invoice description shown to customer

  • amountnumberобязательный

    Invoice amount in KES

  • due_datestringобязательный

    Payment due date YYYY-MM-DD

  • phonestringобязательный

    Customer phone to receive SMS notification

  • account_refstring

    Account reference for the payment

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

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

Bill Manager — Opt In

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

Параметры

  • emailstringобязательный

    Business email for Bill Manager notifications

  • logo_urlstring

    HTTPS URL to your business logo (PNG/JPG)

  • callback_urlstring

    Callback URL for Bill Manager events

mpesa_business_buygoodsвнешний мир

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

Business Buy Goods (B2B)

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

Параметры

  • till_numberstringобязательный

    Destination till number (Buy Goods)

  • amountintegerобязательный

    Amount in KES

  • remarksstring

    Transaction remarks

mpesa_business_paybillвнешний мир

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

Business Pay Bill (B2B)

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

Параметры

  • receiver_paybillstringобязательный

    Destination paybill shortcode

  • amountintegerобязательный

    Amount in KES

  • account_referencestringобязательный

    Account number at destination paybill

  • remarksstring

    Transaction remarks

mpesa_business_pochiвнешний мир

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

Business to Pochi la Biashara

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

Параметры

  • phonestringобязательный

    Pochi wallet owner phone number

  • amountintegerобязательный

    Amount in KES

  • remarksstring

    Remarks

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

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

Dynamic QR Code

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

Параметры

  • merchant_namestringобязательный

    Business/merchant name to display on QR

  • amountintegerобязательный

    Amount in KES to encode in QR

  • ref_nostringобязательный

    Transaction reference number

  • trx_codestring

    BG=Buy Goods, PB=Paybill, WA=Wallet, SM=Send Money, SB=Lipa Shortcode

  • qr_sizeinteger

    QR image size in pixels (300-1000)

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

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

IMSI Query — Phone Verification

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

Параметры

  • phonestringобязательный

    Phone number to verify

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

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

Pull C2B Transactions

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

Параметры

  • start_datestringобязательный

    Start date YYYY-MM-DD HH:MM:SS

  • end_datestringобязательный

    End date YYYY-MM-DD HH:MM:SS

  • offsetinteger

    Pagination offset (0-based)

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

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

Query Org Info

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

Параметры

  • shortcodestringобязательный

    Shortcode to validate (paybill or till number)

mpesa_ratiba_createвнешний мир

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

M-PESA Ratiba — Create Standing Order

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

Параметры

  • standing_order_namestringобязательный

    Name for the standing order

  • start_datestringобязательный

    Start date YYYYMMDD

  • end_datestringобязательный

    End date YYYYMMDD

  • phonestringобязательный

    Customer phone number

  • amountintegerобязательный

    Amount in KES per payment

  • account_refstringобязательный

    Account reference for each payment

  • frequencystring

    1=One-Off 2=Daily 3=Weekly 4=Monthly 5=Bi-Monthly 6=Quarterly 7=Half-Year 8=Annually

  • descriptionstring

    Standing order description

mpesa_reversalвнешний мир

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

M-Pesa Reversal

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

Параметры

  • transaction_idstringобязательный

    M-Pesa receipt to reverse e.g. QKL8XXXXXX

  • amountintegerобязательный

    Amount to reverse in KES

  • remarksstring

    Reason for reversal

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

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

SIM Swap Query

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

Параметры

  • 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

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

Параметры

  • phonestringобязательный

    Customer phone (any Kenyan format: +254..., 07..., 254...)

  • amountintegerобязательный

    Amount in KES (whole number, min 1, max 150000)

  • account_refstringобязательный

    Account reference shown to customer on phone (max 12 chars)

  • descriptionstring

    Transaction description (max 13 chars)

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

Проверьте статус STK Push. Опрашивайте через 10-30 секунд после mpesa_stk_push. ResultCode 0 = успех, 1032 = отменён, 1037 = тайм-аут.

M-Pesa STK Query

Проверьте статус STK Push. Опрашивайте через 10-30 секунд после mpesa_stk_push. ResultCode 0 = успех, 1032 = отменён, 1037 = тайм-аут.

Параметры

  • checkout_request_idstringобязательный

    CheckoutRequestID from mpesa_stk_push response

mpesa_tax_remittanceвнешний мир

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

Tax Remittance to KRA

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

Параметры

  • amountintegerобязательный

    Tax amount in KES

  • account_referencestringобязательный

    KRA Payment Registration Number (PRN)

  • remarksstring

    Remittance remarks

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

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

M-Pesa Transaction Status

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

Параметры

  • transaction_idstringобязательный

    M-Pesa receipt number e.g. QKL8XXXXXX

sms_sendвнешний мир

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

Send SMS

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

Параметры

  • 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

Другие проверенные MCP-сервера

VeriTeknik/pluggedin-mcp-proxy

VeriTeknik/pluggedin-mcp-proxy

официальный

plugged.in MCP Hub — прокси-сервер, объединяющий множество MCP-серверов в один интерфейс. Он наделяет AI памятью, знаниями и инструментами, включает RAG-поиск, уведомления и управление документами. Работает с любыми MCP-клиентами.

TypeScript132
Github MCP

Github MCP

официальный

MCP-сервер для подключения AI-агентов к GitHub: читает код и репозитории, управляет issues и PR, анализирует коммиты и CI/CD. Cервер автоматизирует workflow через естественный язык. Полезен разрабо...

Go31546
centralmind/gateway

centralmind/gateway

официальный

CentralMind Gateway за минуты создаёт MCP-сервер или REST API из вашей базы данных для AI-агентов. Поддерживает популярные СУБД, защищает PII, кэширует и мониторит запросы. Ускоряет интеграцию данн...

Go536
storybookjs/addon-mcp

storybookjs/addon-mcp

официальный

MCP сервер для AI-агентов, интегрирующихся со Storybook: передаёт данные о UI-компонентах и упрощает процессы разработки. Полезен frontend-разработчикам и командам, использующим Storybook для документирования.

TypeScript264
datalayer/jupyter-mcp-server

datalayer/jupyter-mcp-server

официальный

Подключает AI к Jupyter Notebooks в реальном времени: создание, выполнение и редактирование ячеек, переключение между ноутбуками, вывод графиков. Оптимальное решение для автоматизации работы с данн...

Python1216
chatmcp/mcp-server-chatsum

chatmcp/mcp-server-chatsum

MCP-сервер для суммаризации чат-сообщений. Позволяет запрашивать и обобщать переписку с помощью инструмента query_chat_messages. Полезен для анализа бесед и быстрого получения выжимки из чатов.

TypeScript1030
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин