Bayarcash MCP Server 💳
Use AI to manage Bayarcash payments. Create payment links, check transactions, and integrate payment processing using natural language.
Quick Install
Smithery (Easiest):
npx -y @smithery/cli install @khairulimran-97/bayarcash-mcp-server --client claude
Manual Setup:
Add to your config file (~/.config/claude-code/mcp_settings.json):
{
"mcpServers": {
"bayarcash": {
"command": "node",
"args": ["/path/to/bayarcash-mcp-server/build/index.js"],
"env": {
"BAYARCASH_API_TOKEN": "your_token",
"BAYARCASH_API_SECRET_KEY": "your_secret",
"BAYARCASH_SANDBOX": "true"
}
}
}
}
Get your API credentials from https://console.bayar.cash → Settings → API
For detailed usage examples and workflows, see USAGE.md.
What You Can Do
Talk to your AI naturally. The AI will guide you through an intelligent workflow:
Smart Payment Creation
"Create a payment for RM 100"
The AI will automatically:
- Ask if you want to use the email from your last payment (if available)
- Show your payment portals and ask which one to use
- Show payment channels and ask which one to use
- Ask if you want to include a phone number (optional)
- Create the payment and store the payment intent ID
Quick Payment Checks
"Check status of that payment"
"Show me the payment I just created"
The AI uses the stored payment intent ID to check status.
Smart Transaction Filtering
"Show all transactions"
The AI will ask: "Filter by email from last payment: test@example.com?"
More Examples:
"Create payment for RM 50 with portal abc123 using FPX"
"List all successful FPX payments today"
"Find transactions for customer@example.com"
"What payment channels are available?"
"Show me FPX banks"
Features
8 Tools Available:
create_payment_intent- Create payment with guided workflowget_payment_intent- Get payment status by payment intent IDget_transaction- Get transaction by IDget_transaction_by_order- Find transaction by order numberlist_transactions- List transactions with smart filteringget_portals- List your payment portalsget_payment_channels- List available payment channels (10 channels)get_fpx_banks- List FPX online banking banks
Payment Channels (by ID):
- FPX - Online Banking (20+ banks)
- DuitNow - QR payments
- Boost - E-wallet
- GrabPay - E-wallet
- Touch 'n Go - E-wallet
- ShopeePay - E-wallet
- SPayLater - BNPL
- Boost PayFlex - BNPL
- QRIS - QR payments
- NETS - Card payments
Smart Features:
- ✅ Guided payment creation workflow
- ✅ Auto-suggests email from last payment
- ✅ Auto-suggests filtering by last payment email
- ✅ Stores payment intent ID for quick status checks
- ✅ Sandbox & production environments
- ✅ API v3 support (always latest version)
- ✅ Paginated transaction lists with filters
- ✅ Input validation (email, phone, amount)
- ✅ Comprehensive error handling
- ✅ Full TypeScript type safety
Configuration
Environment Variables:
| Variable | Required | Default | Description |
|---|---|---|---|
BAYARCASH_API_TOKEN | Yes | - | Your API token from console.bayar.cash |
BAYARCASH_API_SECRET_KEY | Yes | - | Your API secret key |
BAYARCASH_SANDBOX | No | true | Use sandbox (true) or production (false) |
Note: Server always uses API v3 (latest version). No need to specify version.
Use Cases
For Developers:
"Help me integrate Bayarcash in my Laravel app"
"Create a test payment for RM 50"
"Show me payment channels for my portal"
For Business:
"Show all successful payments today"
"Find transactions for customer@example.com"
"What's the total revenue from FPX this week?"
For more detailed examples and workflows, see USAGE.md.
Troubleshooting
Server not connecting?
- Restart your AI client completely
- Verify API credentials at https://console.bayar.cash
- Check config file path is absolute (not relative)
- Run
npm run buildin server directory
Authentication errors?
- Ensure
BAYARCASH_SANDBOXmatches your account type - Verify no extra spaces in API token/secret
- Try regenerating credentials
Validation errors?
- Email must be valid format
- Phone numbers must be Malaysian format: 60123456789 (starts with 60)
- Amount must be positive with max 2 decimal places
- Payment channel must be 1-10
- Status codes must be 0-4
Getting API errors?
- The server provides detailed error messages for debugging
- Check the error message for specific validation failures
- Use
get_payment_channelsto see available options
Links
- Smithery Marketplace: https://smithery.ai/server/@khairulimran-97/bayarcash-mcp-server
- Repository: https://github.com/khairulimran-97/bayarcash-mcp-server
- Bayarcash: https://bayar.cash
- MCP Docs: https://modelcontextprotocol.io
- Issues: https://github.com/khairulimran-97/bayarcash-mcp-server/issues
License
MIT License - See LICENSE