mpesa-mcp
mpesa-mcp
MCP-сервер для финтех-API в Восточной Африке — M-Pesa (Safaricom Daraja) и Africa's Talking
Предоставьте своему ИИ-агенту возможность инициировать платежи M-Pesa, проверять статус транзакций, отправлять SMS и пополнять баланс в более чем 20 африканских телекоммуникационных сетях.
Зачем это нужно
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
Инструменты
Инструмент | Описание |
| Запуск запроса на оплату STK Push на телефоне клиента M-Pesa |
| Проверка статуса запроса STK Push |
| Запрос любой транзакции M-Pesa по номеру квитанции |
| Отправка SMS от 1 до 1000 получателям в африканских сетях |
| Пополнение баланса любого абонента (KES, NGN, GHS, UGX и т. д.) |
Покрытие
M-Pesa: Кения (Safaricom Daraja v3) — STK Push, C2B, статус транзакции
SMS/Airtime: Кения, Нигерия, Гана, Танзания, Уганда, Руанда, Южная Африка и еще более 15 стран через Africa's Talking
Glama (хостинговый MCP)
mpesa-mcp доступен как хостинговый MCP-сервер на Glama:
Установка
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 |
| ❌ | ✅ | ❌ |
| ✅ | ❌ | ✅ |
| ✅ | ❌ | ✅ |
| ❌ | ✅ | ❌ |
| ❌ | ✅ | ❌ |
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 для получения уведомлений о релизах.
Родственные пакеты
Пакет | Установка | Описание |
| MCP-сервер для анализа засухи в Кении | |
| SDK для гражданского ИИ в Восточной Африке |
Связанные пакеты
Все MIT · Все являются частью стека гражданского ИИ Восточной Африки
Пакет | Установка | Описание |
| MCP-сервер для анализа засухи в Кении | |
| MCP-сервер данных здравоохранения Кении — NHIF, учреждения, материнство, права | |
| SDK для гражданского ИИ в Восточной Африке |
Полное портфолио: gabrielmahia.github.io
Available Tools
5 toolsairtime_sendSend AirtimeADestructive
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 PushADestructive
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 QueryARead-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 StatusARead-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 SMSADestructive
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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
South African MCP server for airtime, data, SMS, VAS, electricity, balance, and network lookup.
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
MCP server for SuperPhone — contacts, conversations, tags and consent-based text messages.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceOpen-source MCP server that streamlines payment integration for AI agents and financial apps in Africa, providing unified tools for providers like M-Pesa.1-- FlicenseNot gradedqualityDmaintenanceAn experimental MCP server that lets AI agents interact with guarded payment workflows through typed tools, enabling safe agent-assisted payments with M-Pesa and mock Airtel Money.3-
- FlicenseNot gradedqualityDmaintenanceA 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-
- AlicenseCqualityDmaintenanceAn 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.7474 npm1MIT