Bayarcash

You can run Bayarcash MCP Server to power AI-guided payment workflows, create payments, check transactions, and integrate Bayarcash payments into your apps with an intelligent agent that handles steps for you.

How to use

Interact with Bayarcash MCP Server through an MCP client to perform common actions like creating payments, checking statuses, and listing transactions. The AI guides you through workflows, prompts for optional data (such as emails or phone numbers), and stores necessary identifiers to streamline follow-up checks. You can ask it to show available payment channels, pick a portal for a payment, or filter transactions by criteria you specify.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Smithery (easiest path): run this command to install the Bayarcash MCP Server client through Smithery and configure it for claude as your MCP client.

npx -y @smithery/cli install @webimpianteam/bayarcash-mcp-server --client claude

Manual setup: add the MCP server configuration to your client config file at ~/.config/claude-code/mcp_settings.json. Use the exact JSON snippet below to register the Bayarcash MCP Server with your client.

{
  "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 the Bayar console at https://console.bayar.cash → Settings → API. You will use these credentials in the configuration above.

Configuration

Environment variables your server needs are listed here. The server always uses API v3 (the latest version). You do not need to specify a version.

Environment variables (from the example configuration): BAYARCASH_API_TOKEN, BAYARCASH_API_SECRET_KEY, BAYARCASH_SANDBOX.

Use cases and features

For developers and business users alike, you can create payments, check statuses, and filter transactions with guided prompts. The server supports a guided payment creation workflow, auto-suggests emails from the last payment, stores the payment intent ID for quick status checks, and provides sandbox and production environments. It works with API v3, supports paginated transaction lists with filters, and includes comprehensive input validation and error handling.

Troubleshooting

If you run into connection or authentication issues, verify your API credentials and sandbox mode, ensure the configuration path is absolute, and rebuild if necessary. Common steps include restarting the MCP client, regenerating credentials if needed, and using get_payment_channels to confirm available options.

Use cases — quick references

For developers: “Help me integrate Bayarcash in my Laravel app” or “Create a test payment for RM 50.” For business: “Show all successful payments today” or “Find transactions for customer@example.com.” The AI will guide you through the workflow and show available channels and portals as you proceed.

Available tools

create_payment_intent

Create a payment with a guided workflow, collecting optional data and storing the payment intent ID for quick status checks.

get_payment_intent

Retrieve a payment's status by its payment intent ID.

get_transaction

Fetch a transaction by its ID.

get_transaction_by_order

Find a transaction using an order number.

list_transactions

List transactions with smart filters and pagination.

get_portals

List your payment portals.

get_payment_channels

List available payment channels (up to 10).

get_fpx_banks

List FPX online banking banks.