World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Unofficial MCP server for FawryPay Pay-at-Fawry cash payments in Egypt. Not affiliated with Fawry.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
FawryPay cash payments (unofficial) をインストールして。https://mcp.popnx.com/i/mohamedaly-cloud-masr-pay-mcp-unofficial.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
FawryPay cash payments (unofficial) のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FAWRY_MERCHANT_CODE) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server FawryPay cash payments (unofficial) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "masr-pay-unofficial": { "command": "uvx", "args": [ "masr-pay-mcp-unofficial" ], "env": { "FAWRY_MERCHANT_CODE": "your-value", "FAWRY_SECURE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FawryPay cash payments (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
FAWRY_MERCHANT_CODE FawryPay の加盟店コード 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"masr-pay-unofficial": {
"command": "uvx",
"args": [
"masr-pay-mcp-unofficial"
],
"env": {
"FAWRY_MERCHANT_CODE": "your-value",
"FAWRY_SECURE_KEY": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FawryPay cash payments (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が FawryPay cash payments (unofficial) を使っていると言うか、回答に FawryPay cash payments (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FAWRY_ENV mock(デフォルト)、staging、または production MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS true で返金およびキャンセルのツールを追加します(加盟店スタッフのみ)。デフォルトはオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ FawryPay cash payments (unofficial) につなげません
FawryPay cash payments (unofficial) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · FawryPay cash payments (unofficial) につなげるアプリを使う
B · その他 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
FawryPay cash payments (unofficial) のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FAWRY_MERCHANT_CODE) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server FawryPay cash payments (unofficial) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user masr-pay-unofficial --env FAWRY_MERCHANT_CODE=your-value --env FAWRY_SECURE_KEY=your-value -- uvx masr-pay-mcp-unofficial 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FawryPay cash payments (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
FAWRY_MERCHANT_CODE FawryPay の加盟店コード 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user masr-pay-unofficial --env FAWRY_MERCHANT_CODE=your-value --env FAWRY_SECURE_KEY=your-value -- uvx masr-pay-mcp-unofficialEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FawryPay cash payments (unofficial) が一覧にあり、接続済みと表示されれば OK です
FawryPay cash payments (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が FawryPay cash payments (unofficial) を使っていると言うか、回答に FawryPay cash payments (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FAWRY_ENV mock(デフォルト)、staging、または production MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS true で返金およびキャンセルのツールを追加します(加盟店スタッフのみ)。デフォルトはオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
FawryPay cash payments (unofficial) のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FAWRY_MERCHANT_CODE) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server FawryPay cash payments (unofficial) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "masr-pay-unofficial": { "command": "uvx", "args": [ "masr-pay-mcp-unofficial" ], "env": { "FAWRY_MERCHANT_CODE": "your-value", "FAWRY_SECURE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FawryPay cash payments (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
FAWRY_MERCHANT_CODE FawryPay の加盟店コード 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
FawryPay cash payments (unofficial) の設定で FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FawryPay cash payments (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が FawryPay cash payments (unofficial) を使っていると言うか、回答に FawryPay cash payments (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FAWRY_ENV mock(デフォルト)、staging、または production MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS true で返金およびキャンセルのツールを追加します(加盟店スタッフのみ)。デフォルトはオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
FawryPay cash payments (unofficial) のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FAWRY_MERCHANT_CODE) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server FawryPay cash payments (unofficial) を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "masr-pay-unofficial": { "type": "stdio", "command": "uvx", "args": [ "masr-pay-mcp-unofficial" ], "env": { "FAWRY_MERCHANT_CODE": "your-value", "FAWRY_SECURE_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、FawryPay cash payments (unofficial) のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
FAWRY_MERCHANT_CODE FawryPay の加盟店コード 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
FawryPay cash payments (unofficial) の設定で FAWRY_SECURE_KEY, FAWRY_MERCHANT_CODE が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
FawryPay cash payments (unofficial) を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が FawryPay cash payments (unofficial) を使っていると言うか、回答に FawryPay cash payments (unofficial) のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
FAWRY_ENV mock(デフォルト)、staging、または production MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS true で返金およびキャンセルのツールを追加します(加盟店スタッフのみ)。デフォルトはオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user masr-pay-unofficial --env FAWRY_MERCHANT_CODE=your-value --env FAWRY_SECURE_KEY=your-value -- uvx masr-pay-mcp-unofficialClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"masr-pay-unofficial": {
"command": "uvx",
"args": [
"masr-pay-mcp-unofficial"
],
"env": {
"FAWRY_MERCHANT_CODE": "your-value",
"FAWRY_SECURE_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"masr-pay-unofficial": {
"command": "uvx",
"args": [
"masr-pay-mcp-unofficial"
],
"env": {
"FAWRY_MERCHANT_CODE": "your-value",
"FAWRY_SECURE_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"masr-pay-unofficial": {
"type": "stdio",
"command": "uvx",
"args": [
"masr-pay-mcp-unofficial"
],
"env": {
"FAWRY_MERCHANT_CODE": "your-value",
"FAWRY_SECURE_KEY": "your-value"
}
}
}
}FAWRY_MERCHANT_CODE 必須 envFAWRY_SECURE_KEY 秘密 必須 envFAWRY_ENV envMASR_PAY_ENABLE_DESTRUCTIVE_TOOLS env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント mohamedaly-cloud で確認済みです
コードの最終更新:18 日前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に masr-pay-mcp-unofficial@0.1.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/mohamedaly-cloud-masr-pay-mcp-unofficial)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:FAWRY_SECURE_KEY
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は18 日前、最新バージョン(0.1.0)がレジストリに届いたのは18 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| これ FawryPay cash payments (unofficial) | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| ライセンス | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
An unofficial MCP server that lets an AI assistant take cash payments in Egypt through FawryPay's Pay-at-Fawry.
[Try it in your browser](https://hdodp82c89.execute-api.eu-west-1.amazonaws.com/): chat with Claude while it uses this server against a mock of Fawry (fake money, nothing to install). For example:
Merchant: Charge Ahmed 150 EGP for order 42, he'll pay cash.
Assistant: Done. Ahmed can pay 150.00 EGP at any Fawry outlet with reference 974376251, before 3 Nov.
*(Ahmed pays at a Fawry shop.)*
Merchant: Did Ahmed pay?
Assistant: Yes, order 42 is paid: 150.00 EGP received on 31 Oct at 22:47.
It's for merchants contracted directly with FawryPay, and for the developers and agencies who build sales bots for them. Paymob has an official MCP server; Fawry doesn't, so this one talks to FawryPay's own API and its network of outlets.
Not affiliated with, endorsed by, or supported by Fawry. "Fawry" and "FawryPay" are used
only to describe the API this project talks to. The server never stores credentials, customer
data or funds.
The quickest way is the browser page (Claude Haiku 5.5, limited messages per day). The same public copy runs on AWS against a mock of Fawry (fake merchant, fake money), so you can also point any MCP client that supports Streamable HTTP and custom headers at it:
{
"type": "http", "url": "https://3t8oh2vfxb.execute-api.eu-west-1.amazonaws.com/mcp", "headers": { "X-Fawry-Merchant-Code": "MOCKMERCHANT0001", "X-Fawry-Secure-Key": "mock-secure-key-not-a-real-fawry-key" } }
Or use MCP Inspector: transport Streamable HTTP, that URL, those two headers.
Then ask your assistant to charge someone, and play the customer paying cash at an outlet:
curl -X POST https://ig7kh4i8u8.execute-api.eu-west-1.amazonaws.com/__admin/kiosk-pay/<reference_number>
The demo is public: use made-up names, phones and emails.
sequenceDiagram
participant M as Merchant participant A as AI assistant participant S as This MCP server participant F as FawryPay participant C as Customer M->>A: "Charge Ahmed 150 EGP for order 42" A->>S: create_cash_payment S->>F: signed charge request F-->>S: reference number (signature verified) S-->>A: reference + instructions A-->>M: "Ahmed can pay with reference 974376251" C->>F: pays cash at a Fawry outlet M->>A: "Did Ahmed pay?" A->>S: get_payment_status S->>F: signed status request F-->>S: PAID (signature verified) A-->>M: "Yes, paid at 22:47"
v0.1. Four tools, over stdio locally and over Streamable HTTP on AWS Lambda, built on the official MCP Python SDK v2 (protocol 2026-07-28). Until FawryPay issues sandbox credentials, everything is built and tested against our own mock of the Fawry API. What still needs Fawry's confirmation is listed in docs/decisions.md.
| Tool | What it does | Safety |
|---|---|---|
create_cash_payment | Creates a Pay-at-Fawry reference for an order (amount in EGP, customer mobile/email, expiry in hours, default 72) | |
get_payment_status | Is it paid? Normalized status (awaiting_payment, paid, expired, …) plus Fawry's raw status | read-only |
cancel_unpaid_payment | Cancels a reference before it's paid | destructive, needs confirmation, off by default |
refund_payment | Refunds a paid order (full by default; one refund per order) | destructive, needs confirmation, off by default, max 2,000 EGP per refund |
Refunds and cancellations are off unless the merchant turns them on (MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS=true). Keep them off when the assistant talks to customers (a sales bot): the person saying "yes" to a refund must be the merchant, never the customer being refunded. Turn them on only for an assistant that the merchant or their staff use.
A destructive tool never acts on the first call. That call returns a preview and a confirmation token, which is HMAC-signed, bound to the exact order, amount and reason, and valid for 5 minutes. The action happens only on a second call that carries the token. The host's approval prompt (destructiveHint) also applies, and when the client supports MCP elicitation the server asks the human directly.
Also built in: one redacted JSON audit line per tool call (stderr), a per-payment limit (default 50,000 EGP), refunds capped at the order amount, and Fawry response signatures verified before anything is reported as paid. See docs/threat-model.md.
The server is on PyPI and speaks stdio. With uv installed, a host runs it with uvx masr-pay-mcp-unofficial, no clone needed. Example host entry (the mcpServers format most MCP hosts use), pointed at the local mock:
{
"mcpServers": { "fawry-unofficial": { "command": "uvx", "args": ["masr-pay-mcp-unofficial"], "env": { "FAWRY_ENV": "mock", "FAWRY_MERCHANT_CODE": "MOCKMERCHANT0001", "FAWRY_SECURE_KEY": "mock-secure-key-not-a-real-fawry-key", "MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS": "true" } } } }
Start the mock first: `uvx --from "masr-pay-mcp-unofficial[mock]" python -m mock_fawry`. From a
clone, use .venv/bin/masr-pay-mcp-unofficial (or python -m masr_pay_mcp) as the command instead.
| Env var | Meaning |
|---|---|
FAWRY_MERCHANT_CODE, FAWRY_SECURE_KEY | Required. Read on every call, never stored. |
FAWRY_ENV | mock (default, http://127.0.0.1:8080), staging or production |
FAWRY_BASE_URL | Overrides the URL picked by FAWRY_ENV |
FAWRY_LOG_LEVEL | Default INFO. Logs go to stderr, redacted. The audit log is always on. |
MASR_PAY_ENABLE_DESTRUCTIVE_TOOLS | true adds cancel_unpaid_payment and refund_payment. Default off. |
MASR_PAY_MAX_PAYMENT_EGP | Per-payment limit, default 50000 |
MASR_PAY_MAX_REFUND_EGP | Per-refund limit, default 2000. Larger refunds go through Fawry directly. |
MASR_PAY_CONFIRM_SECRET | HMAC key for confirmation tokens, at least 32 characters. If unset, a random key per process (fine for stdio). The HTTP server requires it, or: |
MASR_PAY_CONFIRM_SECRET_ARN | HTTP server only: read the key from this Secrets Manager secret (what the AWS stack does). |
See docs/inspector.md to watch the raw MCP traffic.
python scripts/demo.py # create 150 EGP for order 42 -> pay -> "paid?" -> refund preview -> confirm
MCP client --HTTPS--> API Gateway (HTTP API, throttled) --> Lambda: MCP server --> Fawry
\-> mock (demo)
- **Endpoint:** `POST https://<api-id>.execute-api.eu-west-1.amazonaws.com/mcp` (the stack's
McpUrl output), Streamable HTTP, stateless.
X-Fawry-Merchant-Code and X-Fawry-Secure-Key. They're used for that request and never stored or logged. For the public demo, use the mock's fake merchant: MOCKMERCHANT0001 / mock-secure-key-not-a-real-fawry-key.GET /__admin/orders), so never put real customer names, phones or emails into it. Use made-up ones, like 01012345678./masr-pay-mcp/masr-pay-mcp/mcp, one JSON line per tool call, kept 30 days.Deploy:
# once, as an AWS admin: GitHub OIDC deploy role, CloudFormation role, permissions boundary, bucket
aws cloudformation deploy --template-file infra/ci-bootstrap.yaml \ --stack-name masr-pay-mcp-ci --capabilities CAPABILITY_NAMED_IAM
sam build && sam deploy --role-arn --s3-bucket python scripts/smoke_remote.py
python -m mock_fawry # http://127.0.0.1:8080, OpenAPI docs at /docs
| Env var | Default |
|---|---|
MOCK_MERCHANT_CODE | MOCKMERCHANT0001 |
MOCK_SECURE_KEY | a built-in fake key |
MOCK_FAWRY_FEES | 0 (EGP added to each order's payment amount) |
MOCK_HOST / MOCK_PORT | 127.0.0.1 / 8080 |
Fawry endpoints (same paths as Fawry): POST /ECommerceWeb/Fawry/payments/charge, GET /ECommerceWeb/Fawry/payments/status/v2, POST /ECommerceWeb/Fawry/payments/refund, POST /ECommerceWeb/api/orders/cancel-unpaid-order.
Mock-only admin endpoints:
| Endpoint | Does |
|---|---|
POST /__admin/kiosk-pay/{referenceNumber} | Simulates the customer paying cash at an outlet |
GET /__admin/orders | Lists all orders |
POST /__admin/reset | Clears all orders |
Order lifecycle in the mock: UNPAID → PAID (kiosk-pay), UNPAID → EXPIRED (after paymentExpiry), UNPAID → CANCELED, PAID → REFUNDED (one refund per order).
python3.12 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]" pytest ruff check . && ruff format --check .
masr_pay_mcp/server.py the four MCP tools
masr_pay_mcp/web.py the hosted server (Streamable HTTP, for Lambda) masr_pay_mcp/core/confirm.py stateless HMAC confirmation tokens masr_pay_mcp/core/audit.py one structured audit line per tool call masr_pay_mcp/core/guardrails.py payment limit, refund cap masr_pay_mcp/core/redaction.p