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):

Manual Setup: Add to your config file (~/.config/claude-code/mcp_settings.json):

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

The AI will automatically:

1. Ask if you want to use the email from your last payment (if available)

2. Show your payment portals and ask which one to use

3. Show payment channels and ask which one to use

4. Ask if you want to include a phone number (optional)

5. Create the payment and store the payment intent ID

Quick Payment Checks

The AI uses the stored payment intent ID to check status.

Smart Transaction Filtering

The AI will ask: "Filter by email from last payment: test@example.com?"

More Examples:

Features

8 Tools Available:

• create_payment_intent - Create payment with guided workflow

• get_payment_intent - Get payment status by payment intent ID

• get_transaction - Get transaction by ID

• get_transaction_by_order - Find transaction by order number

• list_transactions - List transactions with smart filtering

• get_portals - List your payment portals

• get_payment_channels - List available payment channels (10 channels)

• get_fpx_banks - List FPX online banking banks

Payment Channels (by ID):

1. FPX - Online Banking (20+ banks)

2. DuitNow - QR payments

3. Boost - E-wallet

4. GrabPay - E-wallet

5. Touch 'n Go - E-wallet

6. ShopeePay - E-wallet

7. SPayLater - BNPL

8. Boost PayFlex - BNPL

9. QRIS - QR payments

10. 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:

Note: Server always uses API v3 (latest version). No need to specify version.

Use Cases

For Developers:

For Business:

For more detailed examples and workflows, see USAGE.md.

Troubleshooting

Server not connecting?

1. Restart your AI client completely

2. Verify API credentials at https://console.bayar.cash

3. Check config file path is absolute (not relative)

4. Run npm run build in server directory

Authentication errors?

• Ensure BAYARCASH_SANDBOX matches 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_channels to 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