JazzCash
Open-source Model Context Protocol (MCP) server for JazzCash — Pakistan's largest mobile-money platform. Hosted Checkout, Mobile Wallet charges, inquiries, and refunds for AI agents.
What is JazzCash?
JazzCash is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to open-source model context protocol (mcp) server for jazzcash — pakistan's largest mobile-money platform. hosted checkout, mobile wallet charges, inquiries, and refunds for ai agents.
Open-source Model Context Protocol (MCP) server for JazzCash — Pakistan's largest mobile-money platform. Hosted Checkout, Mobile Wallet charges, inquiries, and refunds for AI agents.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Open-source Model Context Protocol (MCP) server for JazzCash
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx jazzcashmcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use JazzCash
The JazzCash MCP server connects AI agents to JazzCash, Pakistan's largest mobile-money platform, through the Model Context Protocol. It handles Hosted Checkout form generation, direct Mobile Wallet charges, transaction status inquiries, and full or partial refunds — all with cryptographic HMAC-SHA256 signing handled server-side so credentials never pass through the agent. Developers building payment-enabled AI assistants for the Pakistani market can use this server to issue and track payments entirely through natural language.
Prerequisites
- Node.js 18 or later installed
- A JazzCash merchant account with Merchant ID, Password, and Integrity Salt from the JazzCash Developer Portal
- Git to clone the repository
- An MCP client such as Claude Desktop or Cursor
- Set JAZZCASH_ENV to 'sandbox' for testing before switching to 'production'
Clone the repository
Clone the JazzCashMCP repository and enter the project directory.
git clone https://github.com/TehreemArbab/JazzCashMCP.git
cd JazzCashMCPInstall dependencies
Install all Node.js dependencies using npm.
npm installConfigure environment variables
Copy the example environment file and fill in your JazzCash merchant credentials. Set JAZZCASH_ENV to 'sandbox' while testing.
cp .env.example .env
# Edit .env and set:
# JAZZCASH_MERCHANT_ID=your_merchant_id
# JAZZCASH_PASSWORD=your_password
# JAZZCASH_INTEGRITY_SALT=your_salt
# JAZZCASH_ENV=sandbox
# JAZZCASH_RETURN_URL=https://yoursite.com/payment/callbackBuild the TypeScript server
Compile the TypeScript source to JavaScript. Optionally run typecheck to verify there are no compilation errors.
npm run build
npm run typecheckAdd the server to your MCP client configuration
Register the JazzCash MCP server in your Claude Desktop or other MCP client config file so it starts automatically.
Test with a sandbox transaction
Ask your AI assistant to create a hosted checkout or charge a mobile wallet using a test amount while JAZZCASH_ENV is set to 'sandbox'.
JazzCash Examples
Client configuration
Add this block to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json). Replace the env values with your actual credentials.
{
"mcpServers": {
"jazzcash": {
"command": "node",
"args": ["/path/to/JazzCashMCP/dist/index.js"],
"env": {
"JAZZCASH_MERCHANT_ID": "your_merchant_id",
"JAZZCASH_PASSWORD": "your_password",
"JAZZCASH_INTEGRITY_SALT": "your_integrity_salt",
"JAZZCASH_ENV": "sandbox",
"JAZZCASH_RETURN_URL": "https://yoursite.com/payment/callback"
}
}
}
}Prompts to try
Once the server is running, use natural language to interact with JazzCash payment flows.
- "Create a hosted checkout for PKR 1500 with description 'Order #1023' and bill reference 'INV1023'"
- "Charge mobile wallet 03001234567 for PKR 500 with transaction reference TXN-2024-001"
- "Check the status of transaction TXN-2024-001"
- "Refund transaction TXN-2024-001 for PKR 200"
- "Show me the current JazzCash environment settings"Troubleshooting JazzCash
HMAC signature mismatch errors from JazzCash API
Verify that JAZZCASH_INTEGRITY_SALT exactly matches the salt shown in the JazzCash merchant portal — extra whitespace or incorrect casing will cause signature failures.
Build fails with TypeScript compilation errors
Ensure you are running Node.js 18 or later. Run 'npm run typecheck' to see specific errors, then check that your .env file exists and is valid.
Transactions succeed in sandbox but fail in production
Change JAZZCASH_ENV from 'sandbox' to 'production' in your .env file, rebuild with 'npm run build', and confirm your production Merchant ID and Password are set (sandbox and production credentials differ).
Frequently Asked Questions about JazzCash
What is JazzCash?
JazzCash is a Model Context Protocol (MCP) server that open-source model context protocol (mcp) server for jazzcash — pakistan's largest mobile-money platform. hosted checkout, mobile wallet charges, inquiries, and refunds for ai agents. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install JazzCash?
Follow the installation instructions on the JazzCash GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with JazzCash?
JazzCash works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is JazzCash free to use?
Yes, JazzCash is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
JazzCash Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to JazzCash? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up JazzCash in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use JazzCash?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.