jazzcash-mcp

MCP server for JazzCash mobile wallet and payments (Pakistan). Supports wallet payments, mobile account payments, vouchers, refunds, and balance inquiries. Uses HMAC-SHA256 signature authentication.

Tools (8)

Tool	Description
create_payment	Create a mobile wallet payment
check_payment_status	Check payment status
create_mobile_account_payment	Pay from mobile account
refund_payment	Refund a payment
create_voucher	Create a payment voucher
redeem_voucher	Redeem a voucher
get_balance	Check wallet balance
inquire_transaction	Inquire about a transaction

Quick Start

{
  "mcpServers": {
    "jazzcash": {
      "command": "npx",
      "args": ["-y", "@theyahia/jazzcash-mcp"],
      "env": {
        "JAZZCASH_MERCHANT_ID": "<YOUR_MERCHANT_ID>",
        "JAZZCASH_PASSWORD": "<YOUR_PASSWORD>",
        "JAZZCASH_INTEGRITY_SALT": "<YOUR_SALT>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
JAZZCASH_MERCHANT_ID	Yes	Merchant ID from JazzCash portal
JAZZCASH_PASSWORD	Yes	Merchant password
JAZZCASH_INTEGRITY_SALT	Yes	HMAC integrity salt

Demo Prompts

• "Create a JazzCash payment of 5000 PKR to 03001234567"
• "Check status of transaction TXN-001"
• "Refund 3000 PKR for transaction TXN-001"
• "Create a voucher for 2000 PKR"
• "Check wallet balance for 03001234567"

License

MIT