TehreemArbab/JazzCashMCP

git clone https://github.com/TehreemArbab/JazzCashMCP.git
npm install
npm run build && npm start

Usage

• •Sandbox-by-default: set JAZZCASH_MERCHANT_ID, JAZZCASH_PASSWORD, JAZZCASH_INTEGRITY_SALT, and JAZZCASH_ENV in .env; sandbox credentials come from sandbox.jazzcash.com.pk.
• •All amounts are passed as PKR paisa (rupees x 100) to avoid float rounding.
• •To go live, switch JAZZCASH_ENV=production and swap in live merchant credentials — no code changes.
• •Stdio transport works with any MCP client (Cursor, Cline, Continue, Zed, custom TypeScript SDK agents).

Key features

• ✓Five tools: create_hosted_checkout (returns signed form), charge_mobile_wallet, inquire_transaction, refund_transaction, environment_info.
• ✓HMAC-SHA256 signature over alphabetically sorted pp_* fields implemented in one auditable file — no vendored crypto.
• ✓Per-endpoint URL overrides (JAZZCASH_*_URL) so rotated paths need no code change.
• ✓No bundled secrets: credentials come from env only, and tool output never returns secrets.

Best for

Agents that need a stable, typed interface to JazzCash payment flows (checkouts, wallet charges, refunds) for apps operating in Pakistan.

Caveats

• ⚠Status is alpha.
• ⚠Bring-your-own merchant credentials required; you must have a JazzCash merchant account.
• ⚠Stdio transport only, so it has no network listener; it runs as a subprocess of the MCP client.
• ⚠Card/tokenization, webhook helpers, and a CLI are still on the roadmap.