Content
# 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
```json
{
"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
