What it does
Safaricom M-Pesa Daraja tools: STK Push, C2B, B2C, B2B, QR, Ratiba. Sandbox-first, idempotent.
- Connects パソコンで動く
- Account or key Needs DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET
- Category 開発者ツール
一緒に使える
この種の作業を AI に教える Skill。これと一緒に使えます
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
この順位の理由
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
インストール
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
M-Pesa Daraja をインストールして。https://mcp.popnx.com/i/mr-macharia-mpesa-daraja-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
AI にインストールしてもらう
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server M-Pesa Daraja を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "your-value", "DARAJA_CONSUMER_SECRET": "your-value", "DARAJA_PASSKEY": "your-value", "DARAJA_SECURITY_CREDENTIAL": "your-value", "DARAJA_CALLBACK_TOKEN": "your-value", "DARAJA_INITIATOR_PASSWORD": "your-value", "DARAJA_MCP_TOKEN": "your-value", "DARAJA_FORWARD_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、M-Pesa Daraja のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
M-Pesa Daraja に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "your-value", "DARAJA_CONSUMER_SECRET": "your-value", "DARAJA_PASSKEY": "your-value", "DARAJA_SECURITY_CREDENTIAL": "your-value", "DARAJA_CALLBACK_TOKEN": "your-value", "DARAJA_INITIATOR_PASSWORD": "your-value", "DARAJA_MCP_TOKEN": "your-value", "DARAJA_FORWARD_SECRET": "your-value" } } } }キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude を終了してもう一度開く
試してみる
M-Pesa Daraja を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が M-Pesa Daraja を使っていると言うか、回答に M-Pesa Daraja のツール名が出れば接続成功です
追加の設定 18 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
DARAJA_ENVsandbox(既定値)または production英語の原文を見る
sandbox (default) or productionDARAJA_SHORTCODEPaybill / 店舗番号(サンドボックスでは 174379)英語の原文を見る
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI オペレーターのユーザー名(B2C、B2B、status、balance、reversal)英語の原文を見る
API operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLコールバック URL 用の公開 HTTPS ベース英語の原文を見る
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTEN組み込みのコールバック受信機の host:port英語の原文を見る
host:port for the built-in callback receiverDARAJA_TOOLSETSカンマ区切りのリスト: stk,c2b,payouts,ops,qr,ratiba,billmanager英語の原文を見る
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue にすると、資金移動または書き込みを行うすべてのツールが非表示になります。英語の原文を見る
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDこの金額(シリング)を超える支払いは、チャットでの承認が必要です英語の原文を見る
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSpayouts の送信先として許可される電話番号またはショートコードのカンマ区切りリスト英語の原文を見る
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue に設定すると、本番環境での課金と支払いが許可されます英語の原文を見る
true to allow production charges and payoutsDARAJA_CERT_PATHSafaricom の公開証明書へのパス。DARAJA_INITIATOR_PASSWORD と併せて使用英語の原文を見る
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBリクエストの状態とコールバックを保存する SQLite ファイルのパス。英語の原文を見る
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIR生成された QR PNG を保存するディレクトリ英語の原文を見る
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIR保存された設定を格納するディレクトリ(デフォルト: ユーザー設定ディレクトリ)英語の原文を見る
Directory holding the saved config (default: user config dir)DARAJA_DOTENVプロジェクトのものの代わりに読み込む .env ファイルのパス英語の原文を見る
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTHTTP モードのバインドアドレス(デフォルト 127.0.0.1)英語の原文を見る
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTHTTP モードのポート(デフォルト 8000)英語の原文を見る
HTTP mode port (default 8000)DARAJA_FORWARD_URLお使いのアプリの URL:すべてのコールバックはこの URL へ POST され、HMAC で署名されます英語の原文を見る
Your app's URL: every callback is POSTed on to it, HMAC-signed
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ M-Pesa Daraja につなげません
M-Pesa Daraja はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · M-Pesa Daraja につなげるアプリを使う
- M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
- M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server M-Pesa Daraja を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY=your-value --env DARAJA_CONSUMER_SECRET=your-value --env DARAJA_PASSKEY=your-value --env DARAJA_SECURITY_CREDENTIAL=your-value --env DARAJA_CALLBACK_TOKEN=your-value --env DARAJA_INITIATOR_PASSWORD=your-value --env DARAJA_MCP_TOKEN=your-value --env DARAJA_FORWARD_SECRET=your-value -- uvx mpesa-daraja-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、M-Pesa Daraja のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
M-Pesa Daraja に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY=your-value --env DARAJA_CONSUMER_SECRET=your-value --env DARAJA_PASSKEY=your-value --env DARAJA_SECURITY_CREDENTIAL=your-value --env DARAJA_CALLBACK_TOKEN=your-value --env DARAJA_INITIATOR_PASSWORD=your-value --env DARAJA_MCP_TOKEN=your-value --env DARAJA_FORWARD_SECRET=your-value -- uvx mpesa-daraja-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude Code で /mcp と入力
M-Pesa Daraja が一覧にあり、接続済みと表示されれば OK です
試してみる
M-Pesa Daraja を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が M-Pesa Daraja を使っていると言うか、回答に M-Pesa Daraja のツール名が出れば接続成功です
追加の設定 18 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
DARAJA_ENVsandbox(既定値)または production英語の原文を見る
sandbox (default) or productionDARAJA_SHORTCODEPaybill / 店舗番号(サンドボックスでは 174379)英語の原文を見る
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI オペレーターのユーザー名(B2C、B2B、status、balance、reversal)英語の原文を見る
API operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLコールバック URL 用の公開 HTTPS ベース英語の原文を見る
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTEN組み込みのコールバック受信機の host:port英語の原文を見る
host:port for the built-in callback receiverDARAJA_TOOLSETSカンマ区切りのリスト: stk,c2b,payouts,ops,qr,ratiba,billmanager英語の原文を見る
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue にすると、資金移動または書き込みを行うすべてのツールが非表示になります。英語の原文を見る
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDこの金額(シリング)を超える支払いは、チャットでの承認が必要です英語の原文を見る
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSpayouts の送信先として許可される電話番号またはショートコードのカンマ区切りリスト英語の原文を見る
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue に設定すると、本番環境での課金と支払いが許可されます英語の原文を見る
true to allow production charges and payoutsDARAJA_CERT_PATHSafaricom の公開証明書へのパス。DARAJA_INITIATOR_PASSWORD と併せて使用英語の原文を見る
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBリクエストの状態とコールバックを保存する SQLite ファイルのパス。英語の原文を見る
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIR生成された QR PNG を保存するディレクトリ英語の原文を見る
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIR保存された設定を格納するディレクトリ(デフォルト: ユーザー設定ディレクトリ)英語の原文を見る
Directory holding the saved config (default: user config dir)DARAJA_DOTENVプロジェクトのものの代わりに読み込む .env ファイルのパス英語の原文を見る
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTHTTP モードのバインドアドレス(デフォルト 127.0.0.1)英語の原文を見る
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTHTTP モードのポート(デフォルト 8000)英語の原文を見る
HTTP mode port (default 8000)DARAJA_FORWARD_URLお使いのアプリの URL:すべてのコールバックはこの URL へ POST され、HMAC で署名されます英語の原文を見る
Your app's URL: every callback is POSTed on to it, HMAC-signed
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server M-Pesa Daraja を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "your-value", "DARAJA_CONSUMER_SECRET": "your-value", "DARAJA_PASSKEY": "your-value", "DARAJA_SECURITY_CREDENTIAL": "your-value", "DARAJA_CALLBACK_TOKEN": "your-value", "DARAJA_INITIATOR_PASSWORD": "your-value", "DARAJA_MCP_TOKEN": "your-value", "DARAJA_FORWARD_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、M-Pesa Daraja のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
M-Pesa Daraja に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
M-Pesa Daraja の設定で DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Cursor の AI チャットを Agent モードで開く
試してみる
M-Pesa Daraja を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が M-Pesa Daraja を使っていると言うか、回答に M-Pesa Daraja のツール名が出れば接続成功です
追加の設定 18 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
DARAJA_ENVsandbox(既定値)または production英語の原文を見る
sandbox (default) or productionDARAJA_SHORTCODEPaybill / 店舗番号(サンドボックスでは 174379)英語の原文を見る
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI オペレーターのユーザー名(B2C、B2B、status、balance、reversal)英語の原文を見る
API operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLコールバック URL 用の公開 HTTPS ベース英語の原文を見る
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTEN組み込みのコールバック受信機の host:port英語の原文を見る
host:port for the built-in callback receiverDARAJA_TOOLSETSカンマ区切りのリスト: stk,c2b,payouts,ops,qr,ratiba,billmanager英語の原文を見る
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue にすると、資金移動または書き込みを行うすべてのツールが非表示になります。英語の原文を見る
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDこの金額(シリング)を超える支払いは、チャットでの承認が必要です英語の原文を見る
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSpayouts の送信先として許可される電話番号またはショートコードのカンマ区切りリスト英語の原文を見る
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue に設定すると、本番環境での課金と支払いが許可されます英語の原文を見る
true to allow production charges and payoutsDARAJA_CERT_PATHSafaricom の公開証明書へのパス。DARAJA_INITIATOR_PASSWORD と併せて使用英語の原文を見る
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBリクエストの状態とコールバックを保存する SQLite ファイルのパス。英語の原文を見る
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIR生成された QR PNG を保存するディレクトリ英語の原文を見る
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIR保存された設定を格納するディレクトリ(デフォルト: ユーザー設定ディレクトリ)英語の原文を見る
Directory holding the saved config (default: user config dir)DARAJA_DOTENVプロジェクトのものの代わりに読み込む .env ファイルのパス英語の原文を見る
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTHTTP モードのバインドアドレス(デフォルト 127.0.0.1)英語の原文を見る
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTHTTP モードのポート(デフォルト 8000)英語の原文を見る
HTTP mode port (default 8000)DARAJA_FORWARD_URLお使いのアプリの URL:すべてのコールバックはこの URL へ POST され、HMAC で署名されます英語の原文を見る
Your app's URL: every callback is POSTed on to it, HMAC-signed
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
M-Pesa Daraja のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
AI にインストールしてもらう
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server M-Pesa Daraja を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "mpesa-daraja": { "type": "stdio", "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "your-value", "DARAJA_CONSUMER_SECRET": "your-value", "DARAJA_PASSKEY": "your-value", "DARAJA_SECURITY_CREDENTIAL": "your-value", "DARAJA_CALLBACK_TOKEN": "your-value", "DARAJA_INITIATOR_PASSWORD": "your-value", "DARAJA_MCP_TOKEN": "your-value", "DARAJA_FORWARD_SECRET": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、M-Pesa Daraja のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
uv を入れる(まだなければ)
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --version- バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
- "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
ターミナルの開き方
Mac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です:
uv --version一度入れれば、uv を使うすべてのツールで使えます
M-Pesa Daraja に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
M-Pesa Daraja の設定で DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
VS Code の AI チャットを Agent モードで開く
試してみる
M-Pesa Daraja を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が M-Pesa Daraja を使っていると言うか、回答に M-Pesa Daraja のツール名が出れば接続成功です
追加の設定 18 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
DARAJA_ENVsandbox(既定値)または production英語の原文を見る
sandbox (default) or productionDARAJA_SHORTCODEPaybill / 店舗番号(サンドボックスでは 174379)英語の原文を見る
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI オペレーターのユーザー名(B2C、B2B、status、balance、reversal)英語の原文を見る
API operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLコールバック URL 用の公開 HTTPS ベース英語の原文を見る
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTEN組み込みのコールバック受信機の host:port英語の原文を見る
host:port for the built-in callback receiverDARAJA_TOOLSETSカンマ区切りのリスト: stk,c2b,payouts,ops,qr,ratiba,billmanager英語の原文を見る
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue にすると、資金移動または書き込みを行うすべてのツールが非表示になります。英語の原文を見る
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDこの金額(シリング)を超える支払いは、チャットでの承認が必要です英語の原文を見る
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSpayouts の送信先として許可される電話番号またはショートコードのカンマ区切りリスト英語の原文を見る
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue に設定すると、本番環境での課金と支払いが許可されます英語の原文を見る
true to allow production charges and payoutsDARAJA_CERT_PATHSafaricom の公開証明書へのパス。DARAJA_INITIATOR_PASSWORD と併せて使用英語の原文を見る
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBリクエストの状態とコールバックを保存する SQLite ファイルのパス。英語の原文を見る
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIR生成された QR PNG を保存するディレクトリ英語の原文を見る
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIR保存された設定を格納するディレクトリ(デフォルト: ユーザー設定ディレクトリ)英語の原文を見る
Directory holding the saved config (default: user config dir)DARAJA_DOTENVプロジェクトのものの代わりに読み込む .env ファイルのパス英語の原文を見る
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTHTTP モードのバインドアドレス(デフォルト 127.0.0.1)英語の原文を見る
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTHTTP モードのポート(デフォルト 8000)英語の原文を見る
HTTP mode port (default 8000)DARAJA_FORWARD_URLお使いのアプリの URL:すべてのコールバックはこの URL へ POST され、HMAC で署名されます英語の原文を見る
Your app's URL: every callback is POSTed on to it, HMAC-signed
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY=your-value --env DARAJA_CONSUMER_SECRET=your-value --env DARAJA_PASSKEY=your-value --env DARAJA_SECURITY_CREDENTIAL=your-value --env DARAJA_CALLBACK_TOKEN=your-value --env DARAJA_INITIATOR_PASSWORD=your-value --env DARAJA_MCP_TOKEN=your-value --env DARAJA_FORWARD_SECRET=your-value -- uvx mpesa-daraja-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mpesa-daraja": {
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "your-value",
"DARAJA_CONSUMER_SECRET": "your-value",
"DARAJA_PASSKEY": "your-value",
"DARAJA_SECURITY_CREDENTIAL": "your-value",
"DARAJA_CALLBACK_TOKEN": "your-value",
"DARAJA_INITIATOR_PASSWORD": "your-value",
"DARAJA_MCP_TOKEN": "your-value",
"DARAJA_FORWARD_SECRET": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mpesa-daraja": {
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "your-value",
"DARAJA_CONSUMER_SECRET": "your-value",
"DARAJA_PASSKEY": "your-value",
"DARAJA_SECURITY_CREDENTIAL": "your-value",
"DARAJA_CALLBACK_TOKEN": "your-value",
"DARAJA_INITIATOR_PASSWORD": "your-value",
"DARAJA_MCP_TOKEN": "your-value",
"DARAJA_FORWARD_SECRET": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mpesa-daraja": {
"type": "stdio",
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "your-value",
"DARAJA_CONSUMER_SECRET": "your-value",
"DARAJA_PASSKEY": "your-value",
"DARAJA_SECURITY_CREDENTIAL": "your-value",
"DARAJA_CALLBACK_TOKEN": "your-value",
"DARAJA_INITIATOR_PASSWORD": "your-value",
"DARAJA_MCP_TOKEN": "your-value",
"DARAJA_FORWARD_SECRET": "your-value"
}
}
}
}自分で入力する値
DARAJA_CONSUMER_KEY秘密 必須 envDaraja アプリの Consumer Key。英語の原文を見る
Daraja app Consumer KeyDARAJA_CONSUMER_SECRET秘密 必須 envDaraja アプリの Consumer Secret。英語の原文を見る
Daraja app Consumer SecretDARAJA_ENVenvsandbox(既定値)または production英語の原文を見る
sandbox (default) or productionDARAJA_SHORTCODEenvPaybill / 店舗番号(サンドボックスでは 174379)英語の原文を見る
Paybill / store number (174379 in sandbox)DARAJA_PASSKEY秘密 必須 envM-Pesa Express のパスキー(STK Push)英語の原文を見る
M-Pesa Express passkey (STK Push)DARAJA_INITIATOR_NAMEenvAPI オペレーターのユーザー名(B2C、B2B、status、balance、reversal)英語の原文を見る
API operator username (B2C, B2B, status, balance, reversal)DARAJA_SECURITY_CREDENTIAL秘密 必須 env暗号化されたイニシエーターのパスワード英語の原文を見る
Encrypted initiator passwordDARAJA_CALLBACK_BASE_URLenvコールバック URL 用の公開 HTTPS ベース英語の原文を見る
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENenv組み込みのコールバック受信機の host:port英語の原文を見る
host:port for the built-in callback receiverDARAJA_CALLBACK_TOKEN秘密 必須 env16+ random characters; secret path for callbacksDARAJA_TOOLSETSenvカンマ区切りのリスト: stk,c2b,payouts,ops,qr,ratiba,billmanager英語の原文を見る
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYenvtrue にすると、資金移動または書き込みを行うすべてのツールが非表示になります。英語の原文を見る
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDenvこの金額(シリング)を超える支払いは、チャットでの承認が必要です英語の原文を見る
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSenvpayouts の送信先として許可される電話番号またはショートコードのカンマ区切りリスト英語の原文を見る
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTenvtrue に設定すると、本番環境での課金と支払いが許可されます英語の原文を見る
true to allow production charges and payoutsDARAJA_INITIATOR_PASSWORD秘密 必須 envイニシエーターのパスワード。起動時に SecurityCredential として暗号化されます(DARAJA_SECURITY_CREDENTIAL の代替)。英語の原文を見る
Initiator password, encrypted into SecurityCredential at startup (alternative to DARAJA_SECURITY_CREDENTIAL)DARAJA_CERT_PATHenvSafaricom の公開証明書へのパス。DARAJA_INITIATOR_PASSWORD と併せて使用英語の原文を見る
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBenvリクエストの状態とコールバックを保存する SQLite ファイルのパス。英語の原文を見る
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRenv生成された QR PNG を保存するディレクトリ英語の原文を見る
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRenv保存された設定を格納するディレクトリ(デフォルト: ユーザー設定ディレクトリ)英語の原文を見る
Directory holding the saved config (default: user config dir)DARAJA_DOTENVenvプロジェクトのものの代わりに読み込む .env ファイルのパス英語の原文を見る
Path of a .env file to load instead of the project oneDARAJA_MCP_TOKEN秘密 必須 envHTTP モード用の Bearer トークン(32 文字以上のランダムな文字列)。英語の原文を見る
Bearer token for HTTP mode (32+ random characters)DARAJA_MCP_HOSTenvHTTP モードのバインドアドレス(デフォルト 127.0.0.1)英語の原文を見る
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTenvHTTP モードのポート(デフォルト 8000)英語の原文を見る
HTTP mode port (default 8000)DARAJA_FORWARD_URLenvお使いのアプリの URL:すべてのコールバックはこの URL へ POST され、HMAC で署名されます英語の原文を見る
Your app's URL: every callback is POSTed on to it, HMAC-signedDARAJA_FORWARD_SECRET秘密 必須 env転送されるコールバック用の HMAC シークレット(16文字以上)英語の原文を見る
HMAC secret for forwarded callbacks (16+ characters)
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Mr-Macharia で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:16 日前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
公開済みの脆弱性(OSV.dev)
OSV.dev に mpesa-daraja-mcp@0.1.6 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/mr-macharia-mpesa-daraja-mcp)話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの6202件のうち0%よりスターが多い
- このカテゴリのほかの6202件のうち57%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの6202件のうち99%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
M-Pesa Darajaは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は16 日前、最新バージョン(0.1.6)がレジストリに届いたのは22 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは?
同じカテゴリには:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
似た働きのほかの候補
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| これ M-Pesa Daraja | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドでもパソコンにインストールでも使える |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| ライセンス | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
mpesa-daraja
Renamed from
mpesa-daraja-mcpin 0.1.5. The old package name still installs this one.
The MCP server in the M-Pesa Daraja Agent Kit. It lets an AI agent call Safaricom's Daraja API safely.
An MCP server that exposes Safaricom's Daraja APIs as tools, so an agent (Claude Code, Codex, Cursor, Gemini CLI, any MCP client) can collect payments, check whether they went through, and operate M-Pesa from a chat. It starts in the sandbox, and nothing live happens until you switch it on.
It pairs with the Agent Skills in the same kit: the skills teach an agent *how* to integrate M-Pesa, and this server lets it *call* Daraja. You can use either on its own.
Who it's for
- Developers building payment integrations: ask your agent to run a request against the sandbox and read the real response.
- Learners finding out how the Daraja API works: send real requests to a safe test environment and see what comes back.
- Businesses and teams that want an AI agent to handle payments: collecting them, checking whether they went through, and reconciling them.
Install
Let your agent do it. Paste this into Claude Code, Codex, Cursor, Gemini CLI or any coding agent:
Add the M-Pesa Daraja MCP server to yourself, named "mpesa", with the command: uvx mpesa-daraja-mcp
It needs no keys in your config. If uv is missing, tell me how to install it first. Don't ask me for my Daraja keys. Tell me to run uvx mpesa-daraja-mcp init in my own terminal, which saves them privately, then to restart you. After I restart you, call mpesa_check_credentials and tell me if everything works.
Or do it yourself. You need uv. The wizard asks for your Daraja keys (secrets are typed hidden), checks them live with Safaricom, saves them to a file only you can read, and registers the server with Claude Code, Codex, Gemini CLI or Cursor:
uvx mpesa-daraja-mcp init
Then restart your agent and ask: *"Check my M-Pesa credentials, then send a KES 1 STK push to 0712345678 and tell me when it's paid."* The full Agent Kit, with the skills and more examples, is in the main README.
Tools
| Tool | Daraja API | Moves money |
|---|---|---|
mpesa_explain_code | — offline error/result code lookup | |
mpesa_normalize_phone | — offline 07… → 2547… | |
mpesa_generate_stk_password | — offline Password + EAT Timestamp | |
mpesa_parse_callback | — offline parse of any callback payload | |
mpesa_setup_status | — offline: what's configured and missing per toolset (no values) | |
mpesa_check_credentials | OAuth token (never returned) | |
mpesa_get_result | Final status by idempotency key or any Daraja ID (from captured callbacks; STK falls back to STK Query) | |
mpesa_stk_push_and_wait | M-Pesa Express: push, then wait for callback / poll query; returns SUCCESS, FAILED or UNKNOWN | ✅ |
mpesa_stk_push / mpesa_stk_query | M-Pesa Express, fire-and-forget / status | ✅ / |
mpesa_c2b_register_urls / mpesa_c2b_simulate | C2B v2 (simulate = sandbox only) | |
mpesa_pull_transactions | Pull Transactions query | |
mpesa_b2c_payment | B2C v3, B2Pochi | ✅ |
mpesa_b2b_payment | BusinessPayBill, BusinessBuyGoods, BusinessPayToBulk (B2C top-up), PayTaxToKRA | ✅ |
mpesa_b2b_express_checkout | B2B USSD push | ✅ |
mpesa_transaction_status / mpesa_account_balance | Status / Balance (async result) | |
mpesa_reverse_transaction | Reversal | ✅ |
mpesa_generate_dynamic_qr | Dynamic QR, saved as a PNG file (path returned, not the image) | |
mpesa_ratiba_create_standing_order | M-Pesa Ratiba | ✅ |
mpesa_bill_manager_optin / mpesa_bill_manager_send_invoice / mpesa_bill_manager_cancel_invoice | Bill Manager |
Tool annotations mark money-moving tools as destructiveHint, so MCP clients ask for approval.
Safety
- Defaults to the sandbox.
- In production, money-moving tools refuse to run unless
DARAJA_ALLOW_LIVE_MONEY_MOVEMENT=true. - Optional guardrails, all off until set:
DARAJA_READ_ONLY=truehides every tool that moves money or writes. Use it for support bots, reconciliation and learning.DARAJA_APPROVAL_THRESHOLD=5000: B2C, B2B, tax and reversals above KES 5,000 pause for a yes/no in the chat (MCP elicitation). Clients that can't show the prompt get a refusal, and nothing is sent. Collections (STK, B2B Express, Ratiba) never prompt, because the payer enters their own PIN.DARAJA_ALLOWED_RECIPIENTS=0712345678,600000: payouts may go only to these phones and shortcodes.- For a B2C refund, pass
refund_ofwith the original M-Pesa receipt; it appears in the approval prompt and the remarks. - Callback URLs must be HTTPS; C2B URLs with
mpesa/safaricomin them are rejected up front. - Tokens and secrets are never returned in tool output.
- Responses with
ResponseCode "0"are tagged_note: ACCEPTED for processing only, so the agent does not report them as completed payments. - Idempotent money tools. Each request is stored under an idempotency key. Repeating the key returns the stored request (
duplicate: true) instead of paying again. - Only a definitively FAILED request is re-sent.
- ACCEPTED or UNKNOWN requests (queue timeouts, network errors) are never re-sent until their result is known.
- B2C, B2B and B2B Express require an explicit
idempotency_key, e.g.refund-order-1042. Reversal, tax and Ratiba derive one from the transaction ID, the PRN and phone + name respectively. For STK the key is optional.
Configuration
| Variable | Required | Notes |
|---|---|---|
DARAJA_ENV | sandbox (default) or production | |
DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET | ✅ | From your Daraja app |
DARAJA_SHORTCODE | most tools | Paybill / store number (174379 in sandbox) |
DARAJA_PASSKEY | STK | Lipa na M-Pesa passkey |
DARAJA_INITIATOR_NAME | B2C/B2B/status/balance/reversal | API operator username |
DARAJA_SECURITY_CREDENTIAL | same | Pre-encrypted credential, or set the next two |
DARAJA_INITIATOR_PASSWORD + DARAJA_CERT_PATH | Server encrypts the password with the cert at startup | |
DARAJA_CALLBACK_BASE_URL | e.g. https://abc.ngrok-free.app; tools append /mpesa/stk/callback, /mpesa/b2c/result, … | |
DARAJA_ALLOW_LIVE_MONEY_MOVEMENT | true to allow production charges/payouts | |
DARAJA_CALLBACK_LISTEN | e.g. 127.0.0.1:8787: starts the built-in callback receiver | |
DARAJA_CALLBACK_TOKEN | with receiver | 16+ random characters. Callback URLs become /cb/ /… |
DARAJA_STATE_DB | SQLite file for requests and results (default ~/.mpesa-mcp/state.db) | |
DARAJA_TOOLSETS | Comma list of stk,c2b,payouts,ops,qr,ratiba,billmanager (core is always on). Default: all | |
DARAJA_READ_ONLY | true hides every tool that moves money or writes | |
DARAJA_APPROVAL_THRESHOLD | Payouts above this many shillings need a yes in the chat | |
DARAJA_ALLOWED_RECIPIENTS | Comma list of phones/shortcodes that payouts may go to | |
DARAJA_OUTPUT_DIR | Where QR PNGs are saved (default ~/.mpesa-mcp/qr) | |
DARAJA_FORWARD_URL | Your app's endpoint. Each callback is POSTed on to it, signed. See forwarding | |
DARAJA_FORWARD_SECRET | with forwarding | 16+ random characters, used for the X-Mpesa-Signature HMAC |
DARAJA_MCP_TOKEN | HTTP mode | 32+ random characters; clients send Authorization: Bearer |
DARAJA_MCP_HOST, DARAJA_MCP_PORT | HTTP mode bind address and port (default 127.0.0.1:8000) |
Commands and configuration files
Install once with uv tool install mpesa-daraja-mcp to get the mpesa command (or prefix any command with uvx mpesa-daraja-mcp instead of mpesa):
mpesa init # guided: keys (hidden input), live check, save, register with your agents
mpesa status # what's configured (masked), the guardrails, and a live key check mpesa dev # callback receiver + tunnel (cloudflared or ngrok) + a live log of callbacks mpesa serve [--http] # the MCP server: stdio for local agents, HTTP for remote ones mpesa up --domain pay.example.com # self-host with Docker and automatic HTTPS mpesa pay stk 0712345678 10 --ref order-42 # waits for the PIN and shows the outcome mpesa pay b2c 0712345678 500 --key refund-42 --refund-of NLJ7RT61SV mpesa result · mpesa balance · mpesa explain 1032 mpesa skills install # copy the Agent Skills into Claude Code, Codex, Cursor, … mpesa upgrade
Every data command takes --json, and mpesa --verbose … logs each HTTP request to Daraja. A failed STK Push shows the --key to retry it with. Payments use the same guardrails as the MCP tools, and approvals are asked in the terminal. uvx mpesa-daraja-mcp with no arguments is the MCP server on stdio, which is what your agent runs.
The server needs no flags or environment variables in your agent's config. Settings are read in this order, highest first:
- Environment variables, e.g. from the client's
envblock. - A project `.env` in the folder the agent starts the server in, or the file named by
DARAJA_DOTENV. OnlyDARAJA_*lines are read. - The user config file that
setupwrites:~/.config/mpesa-daraja-mcp/config.env(Windows:%APPDATA%\mpesa-daraja-mcp\config.env; override the folder withDARAJA_CONFIG_DIR). It is readable only by you.
The server starts even when unconfigured. Tools then explain what's missing, and mpesa_setup_status lists the gaps for each toolset without revealing any values.
To register by hand: claude mcp add --scope user mpesa -- uvx mpesa-daraja-mcp. Every other agent is covered in docs/clients.md. The mpesa-daraja and mpesa-mcp commands are aliases.
Remote access (HTTP mode)
mpesa serve --http serves MCP at /mcp and Daraja callbacks at /cb/ /… on one port, for n8n, cloud agents and teammates. It needs DARAJA_MCP_TOKEN, and starts read-only with every payout needing approval unless you say otherwise. Docker, HTTPS and n8n guides: https://github.com/Mr-Macharia/mpesa-daraja-skills-and-mcp/blob/main/docs/self-hosting.md
Results and callbacks
Every money or async tool returns one shape:
{"status": "ACCEPTED | SUCCESS | FAILED | UNKNOWN", "message": "...", "idempotency_key": "...",
"duplicate": false, "ids": {"checkout_request_id": "..."}, "receipt": "...", "result_code": "...", "explanation": "...", "raw": {}}
To let the agent see final results, enable the built-in receiver:
export DARAJA_CALLBACK_LISTEN=127.0.0.1:8787
export DARAJA_CALLBACK_TOKEN=$(python -c "import secrets; print(secrets.token_urlsafe(24))") ngrok http 8787 # sandbox; use a reverse proxy with TLS in production export DARAJA_CALLBACK_BASE_URL=https://
Callbacks are stored in DARAJA_STATE_DB:
mpesa_get_result(id)reads them.mpesa_stk_push_and_waitreturns the final outcome in one call.- Queue-timeout callbacks are recorded as UNKNOWN.
- C2B validation requests are always accepted. Use yo