Skip to main content
Glama

mpesa-mcp

MCP-сервер для финтех-API в Восточной Африке — M-Pesa (Safaricom Daraja) и Africa's Talking

Предоставьте своему ИИ-агенту возможность инициировать платежи M-Pesa, проверять статус транзакций, отправлять SMS и пополнять баланс в более чем 20 африканских телекоммуникационных сетях.

Tests PyPI License: MIT Glama Score Glama

mpesa-mcp MCP server

Зачем это нужно

M-Pesa обрабатывает больше транзакций в день, чем PayPal в Африке. Africa's Talking охватывает пользователей в более чем 20 странах на простых телефонах через SMS и USSD. Ни у одного из них нет MCP-сервера.

Это означает, что любой ИИ-агент, созданный сегодня — Claude, GPT, Gemini или любая среда выполнения, совместимая с MCP, — не может инициировать платеж M-Pesa или отправить SMS на суахили без специальной интеграции.

mpesa-mcp устраняет этот пробел с помощью одной команды pip install.

Related MCP server: M-Pesa MCP Server

Инструменты

Инструмент

Описание

mpesa_stk_push

Запуск запроса на оплату STK Push на телефоне клиента M-Pesa

mpesa_stk_query

Проверка статуса запроса STK Push

mpesa_transaction_status

Запрос любой транзакции M-Pesa по номеру квитанции

sms_send

Отправка SMS от 1 до 1000 получателям в африканских сетях

airtime_send

Пополнение баланса любого абонента (KES, NGN, GHS, UGX и т. д.)

Покрытие

  • M-Pesa: Кения (Safaricom Daraja v3) — STK Push, C2B, статус транзакции

  • SMS/Airtime: Кения, Нигерия, Гана, Танзания, Уганда, Руанда, Южная Африка и еще более 15 стран через Africa's Talking

Glama (хостинговый MCP)

mpesa-mcp доступен как хостинговый MCP-сервер на Glama:

mpesa-mcp MCP server mpesa-mcp score

Установка

pip install mpesa-mcp

Или запустите напрямую с помощью uvx:

uvx mpesa-mcp

Конфигурация

Установите эти переменные окружения перед запуском сервера:

# M-Pesa (Safaricom Daraja)
MPESA_CONSUMER_KEY=your_consumer_key
MPESA_CONSUMER_SECRET=your_consumer_secret
MPESA_SHORTCODE=174379               # sandbox test shortcode
MPESA_PASSKEY=your_passkey
MPESA_CALLBACK_URL=https://yourdomain.com/mpesa/callback
MPESA_SANDBOX=true                   # set false for production

# Africa's Talking
AT_USERNAME=sandbox                  # your AT username (sandbox for testing)
AT_API_KEY=your_at_api_key

Песочница (Sandbox)

M-Pesa sandbox: https://developer.safaricom.co.ke — создайте бесплатное приложение, чтобы получить тестовые учетные данные.

  • Тестовый короткий код: 174379

  • Тестовый пароль (passkey): bfb279f9aa9bdbcf158e97dd71a467cd2e0c893059b10f78e6b72ada1ed2c919

Africa's Talking sandbox: https://account.africastalking.com — используйте username=sandbox и любой API-ключ.

Использование с Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "mpesa": {
      "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"
      }
    }
  }
}

Использование с Claude Code

claude mcp add mpesa -- uvx mpesa-mcp

Установите переменные окружения в вашей оболочке перед запуском claude.

Примеры промптов

После подключения вы можете попросить своего ИИ-агента:

"Отправь STK Push на сумму 500 KES на номер +254712345678 для заказа #1234"

"Проверь, был ли получен платеж QKL8ABC123"

"Отправь SMS этим 5 фермерам с сегодняшней ценой на кукурузу: [список]"

"Пополни баланс на 50 KES для наших полевых агентов: [список номеров]"

Реальные сценарии

Выплата полевым агентам

"Отправь STK Push на сумму 300 KES каждому из этих 12 полевых агентов для сегодняшнего сбора данных: [список]"

Агент инициирует 12 последовательных STK-запросов, отслеживает каждый checkout_request_id и опрашивает систему для подтверждения — без написания вами кода.

Оповещение фермеров + пополнение баланса

"Отправь SMS этим 200 фермерам в Гариссе, что уровень реки поднимается. Затем пополни баланс каждого на 20 KES, чтобы они могли позвонить и сообщить отчеты."

Один промпт → 200 SMS-сообщений и 200 пополнений баланса в сетях Safaricom, Airtel и Telkom.

Сверка платежей

"Проверь, был ли платеж по квитанции OKL8M3B2HF успешным и на какую сумму"

Полезно для агентов поддержки, использующих Claude для проверки транзакций M-Pesa в режиме реального времени.

Аннотации инструментов

Все инструменты объявляют аннотации инструментов MCP, чтобы клиенты могли соответствующим образом ограничивать вызовы:

Инструмент

readOnly

destructive

idempotent

mpesa_stk_push

❌

✅

❌

mpesa_stk_query

✅

❌

✅

mpesa_transaction_status

✅

❌

✅

sms_send

❌

✅

❌

airtime_send

❌

✅

❌

Claude Desktop и другие MCP-клиенты будут запрашивать подтверждение перед запуском операций оплаты, отправки SMS или пополнения баланса.

Обнаружение сервера

Возможности рекламируются через .well-known/mcp.json — новый стандарт MCP Server Cards. Реестры и браузеры могут индексировать инструменты этого сервера без подключения к нему.

# Check capabilities
curl https://raw.githubusercontent.com/gabrielmahia/mpesa-mcp/main/.well-known/mcp.json

Тестирование и точность

Бенчмарк экосистемы MCP (CData, 2026) показал, что большинство MCP-серверов точны в 60–75% случаев при выполнении сложных запросов — особенно при скрытых сбоях в операциях записи и частичном применении параметров.

mpesa-mcp протестирован на всех трех форматах кенийских телефонных номеров, граничных значениях сумм и отсутствующих необязательных полях:

pytest tests/ -v  # run full suite
pytest tests/test_phone_formats.py  # format normalization
pytest tests/test_boundary_amounts.py  # min/max amount edge cases

Операции записи (STK push, SMS, пополнение баланса) проходят явную проверку перед выполнением любого вызова API.

Контекст экосистемы — Mojaloop + MCP

Mojaloop (финансируемый Фондом Гейтса) обеспечивает функциональную совместимость платежей — соединяя банки, мобильные кошельки и продавцов через DFSP в Восточной Африке и за ее пределами.

mpesa-mcp обеспечивает уровень инструментов для ИИ-агентов — позволяя ИИ-помощникам программировать и запрашивать платежи M-Pesa программно.

Они дополняют друг друга:

  • Mojaloop: рельсы функциональной совместимости между финансовыми провайдерами

  • mpesa-mcp: уровень интерфейса MCP, который соединяет ИИ-агентов с этими рельсами

См. вклад в документацию Mojaloop для получения дополнительной информации об этом шаблоне.

MCP против A2A — два разных протокола

mpesa-mcp реализует MCP (Model Context Protocol) — то, как ИИ-агент взаимодействует с инструментами.

Существует дополнительный протокол, A2A (Agent-to-Agent), который управляет тем, как агенты общаются друг с другом. Они решают разные проблемы и работают вместе:

  • MCP: Ваш ИИ-агент → mpesa-mcp → Daraja API / Africa's Talking

  • A2A: Агент-оркестратор ↔ платежный субагент ↔ субагент уведомлений

Для большинства интеграций вам нужен только MCP. A2A становится актуальным, когда вы создаете мультиагентные системы, где платежный рабочий процесс координируется с другими специализированными агентами.


Разработка

git clone https://github.com/gabrielmahia/mpesa-mcp
cd mpesa-mcp
pip install -e ".[dev]"
pytest tests/ -v

Безопасность

Не коммитьте API-ключи. Используйте переменные окружения или менеджер секретов. Сообщайте об уязвимостях по адресу: contact@aikungfu.dev

Лицензия

MIT — © 2026 Gabriel Mahia

Будьте в курсе

Получайте уведомления о новых релизах и разработках API в Восточной Африке: Подписаться на обновления →

Или следите за этим репозиторием на GitHub для получения уведомлений о релизах.

Родственные пакеты

Пакет

Установка

Описание

wapimaji-mcp

pip install wapimaji-mcp

MCP-сервер для анализа засухи в Кении

civic-agent-kit

pip install civic-agent-kit

SDK для гражданского ИИ в Восточной Африке

Связанные пакеты

Все MIT · Все являются частью стека гражданского ИИ Восточной Африки

Пакет

Установка

Описание

wapimaji-mcp

pip install wapimaji-mcp

MCP-сервер для анализа засухи в Кении

kenya-health-mcp

pip install kenya-health-mcp

MCP-сервер данных здравоохранения Кении — NHIF, учреждения, материнство, права

civic-agent-kit

pip install civic-agent-kit

SDK для гражданского ИИ в Восточной Африке

Полное портфолио: gabrielmahia.github.io

Available Tools

5 tools
airtime_sendSend AirtimeA
Destructive

Send airtime top-up to any MTN/Safaricom/Airtel/Vodafone subscriber. Common use: NGO field incentives, survey rewards, agent payouts. No real airtime sent in sandbox mode.

Inputs: phone (required), amount (required), currency_code. Returns: object

mpesa_stk_pushM-Pesa STK PushA
Destructive

Trigger an M-Pesa STK Push — sends a payment prompt to the customer's phone. The customer enters their M-Pesa PIN to complete payment. Returns a CheckoutRequestID to track the transaction with mpesa_stk_query. Async: use mpesa_stk_query after 10-30 seconds to check completion.

Inputs: phone (required), amount (required), account_ref (required), description. Returns: object

mpesa_stk_queryM-Pesa STK QueryA
Read-onlyIdempotent

Check the status of an STK Push request. Poll this 10-30 seconds after calling mpesa_stk_push. ResultCode 0 = success, 1032 = cancelled by user, 1037 = timed out.

Inputs: checkout_request_id (required). Returns: object

mpesa_transaction_statusM-Pesa Transaction StatusA
Read-onlyIdempotent

Query the status of any M-Pesa transaction by receipt number. Requires MPESA_INITIATOR_NAME and MPESA_SECURITY_CREDENTIAL env vars.

Inputs: transaction_id (required). Returns: object

sms_sendSend SMSA
Destructive

Send SMS to one or many recipients via Africa's Talking. Supports up to 1,000 recipients per call. Works across Kenya, Nigeria, Ghana, Tanzania, Uganda, and 15+ African markets. Returns per-recipient status and cost.

Inputs: message (required), recipients (required), sender_id. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct function: airtime sending, STK push initiation, STK push status query, transaction status by receipt, and SMS sending. There is no overlap or ambiguity.

    Naming Consistency4/5

    Most tools follow a verb_noun or noun_verb pattern (e.g., airtime_send, sms_send, mpesa_stk_push), but mpesa_transaction_status lacks a verb, breaking the pattern slightly.

    Tool Count5/5

    With 5 tools, the server is well-scoped for its purpose, covering core M-Pesa and SMS operations without being too few or too many.

    Completeness3/5

    The set covers STK push initiation/query and basic transaction status, but lacks airtime status, B2C/C2B transfers, or account balance queries, leaving notable gaps for a full M-Pesa integration.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Open-source MCP server that streamlines payment integration for AI agents and financial apps in Africa, providing unified tools for providers like M-Pesa.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that integrates Safaricom's M-PESA Daraja API with Claude, enabling natural language payment processing and real-time transaction notifications.
      3
      -
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that enables AI assistants to interact with Interswitch APIs for payments, transfers, VAS, cardless paycodes, Transaction Search, Card 360, lending, payouts, agency banking, and fintech card-processing utilities.
      74
      74 npm
      1
      MIT