Egypt Payments (Paymob — cards / mobile wallets)

Official3 tools

by junter1989k-ai · JavaScript

Egypt payments for AI agents — cards / mobile wallets via Paymob. Never holds funds.

This MCP server enables AI agents to accept payments in Egypt. It supports card and mobile-wallet payment flows via Paymob, and it explicitly states that it never holds funds. Tooling is exposed through an HTTP MCP endpoint for MCP-capable clients.

🛠️ Key Features

Payments for Egypt via Paymob
Accepts cards and mobile wallets
Does not hold funds
Exposes an MCP server over HTTP
Credentials, when required, are sent as HTTP headers on each request

🚀 Use Cases

Let AI agents take payments in Egypt
Integrate Egypt payment acceptance into an MCP-capable agent workflow

⚡ Developer Benefits

MCP client config can point to https://mcp-eg.wishpool.app/mcp
No installation required
Credentials are not stored by the server

⚠️ Limitations

Funds are not held by the MCP server
Additional setup details beyond HTTP configuration are not included in the excerpt

Topics

ai-agentclaudeegyptmcpmcp-serverpaymentswishpool

Captured live from the server via tools/list.

create_payment_link

Create a payment link in EGP for Egypt via Paymob. Buyer pays with cards, mobile wallets (Vodafone Cash and others) via Paymob. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-paymob-api-key; free test credentials from accept.paymob.com never move real money). Money always flows buyer→Paymob→merchant; this service never touches funds.

Parameters5

amount_egp	number	required	Amount in EGP (decimals allowed), e.g. 50. Minimum 5.
description	string	required	What this payment is for (shown to the buyer, ≤200 chars)
customer_email	string	optional	Optional buyer email.
reference_id	string	optional	Your unique order reference (≤40 chars). Auto-generated if omitted.
success_url	string	optional	Optional https URL to send the buyer to after payment.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_egp": {
      "type": "number",
      "minimum": 5,
      "maximum": 10000000,
      "description": "Amount in EGP (decimals allowed), e.g. 50. Minimum 5."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email."
    },
    "reference_id": {
      "type": "string",
      "description": "Your unique order reference (≤40 chars). Auto-generated if omitted."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    }
  },
  "required": [
    "amount_egp",
    "description"
  ]
}

query_payment_status

Check whether a Egypt payment (created by create_payment_link) has been paid. Queries Paymob directly — pull-based, no webhook needed. paid=true when status is PAID.

Parameters1

order_id

string

required

The Paymob order_id returned by create_payment_link

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The Paymob order_id returned by create_payment_link"
    }
  },
  "required": [
    "order_id"
  ]
}

refund_payment

Refund a paid Egypt payment (created by create_payment_link) via Paymob. Provide transaction_id (from query_payment_status.transaction_id) OR order_id (the Paymob order_id from create_payment_link — the tool looks it up to find the transaction and its paid amount). Full refund by default (needs order_id so the paid amount can be looked up); pass amount_egp for a partial refund. Refunds respect the same owner policy guardrails (x-agentpay-max-amount) as payments — the refund amount is checked before anything is sent to Paymob.

Parameters3

transaction_id	string	optional	Paymob transaction id of the paid payment (from query_payment_status.transaction_id). Provide this or order_id.
order_id	string	optional	The Paymob order_id returned by create_payment_link. Provide this or transaction_id; required for a full refund (used to look up the paid amount).
amount_egp	number	optional	Optional partial-refund amount in EGP (decimals allowed). Omit for a full refund of the payment (order_id required).

Raw schema

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "string",
      "description": "Paymob transaction id of the paid payment (from query_payment_status.transaction_id). Provide this or order_id."
    },
    "order_id": {
      "type": "string",
      "description": "The Paymob order_id returned by create_payment_link. Provide this or transaction_id; required for a full refund (used to look up the paid amount)."
    },
    "amount_egp": {
      "type": "number",
      "description": "Optional partial-refund amount in EGP (decimals allowed). Omit for a full refund of the payment (order_id required)."
    }
  },
  "required": []
}

README.md3 KBView on GitHub

Egypt Payments MCP — let AI agents accept payments in Egypt

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "egypt-payments": {
      "type": "http",
      "url": "https://mcp-eg.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/egypt-payments-mcp && cd egypt-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-eg.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/egypt-payments-mcp · Part of a 50-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Egypt: cards, mobile wallets (Vodafone Cash and others) via Paymob — via Paymob's hosted checkout.

⚖️ Stateless translation layer: funds always flow buyer → Paymob → merchant directly. Never holds funds or stores credentials — no database at all.

Quick start

MCP endpoint: https://mcp-eg.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Header	Value
`x-paymob-api-key`	your Paymob credentials from accept.paymob.com dashboard (test-mode integrations never move real money); optional x-paymob-mode: test

Tools

Tool	What it does
`create_payment_link`	Create a EGP hosted-checkout link.
`query_payment_status`	Pull-based status check; `paid=true` when PAID.
`refund_payment`	Refund a paid payment (full or partial) via `transaction_id` or `order_id`.

Develop

bash

node test/serve.js      # local server (http://localhost:3258/mcp)
node test/e2e.js        # protocol + validation suite (probes real Paymob auth errors)

Zero runtime dependencies; Node ≥ 18. MIT license.

Install

Tools (3)

create_payment_linkquery_payment_statusrefund_payment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-eg.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "egypt-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-eg.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_payment_link

query_payment_status

refund_payment

Egypt Payments MCP — let AI agents accept payments in Egypt

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers