Bayarcash

You run an MCP server that lets an AI assistant create and manage Bayarcash payments. It handles payment intents, transactions, and channels through a simple Node-based server, enabling you to guide users through secure payment workflows with natural language.

How to use

You connect an MCP client to the Bayarcash MCP server and interact with it through natural language. The AI guides you through creating payments, checking statuses, and filtering transactions. You can, for example, instruct the AI to create a payment for a specific amount, then have it show available payment portals and channels, ask for optional details like an email or phone number, and finally return a stored payment intent ID for quick status checks.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You may also install an MCP client tool if you plan to manage the server through specific client features.

Step 1: Install or prepare the Bayarcash MCP server client via the provided installer command (the client handles MCP interactions). Run this once to set up the client side.

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

Configuration and starting the server

Configure the server with the required API credentials and environment settings. Use a local path to the built server entry point and supply your credentials in the environment. The server runs as a stdio process started with Node and the path to the built index file.

{
  "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"
      }
    }
  }
}

Start the server

Run the Node entry point with the environment variables set as shown above. The server will expose the MCP endpoints through the configured stdio process. If you prefer an automated start, place the configuration in the appropriate MCP config file and start the host process that manages MCP servers.

Additional configuration notes

• Store credentials securely and rotate API keys regularly.
• Use BAYARCASH_SANDBOX to test in a safe environment before switching to production.
• Ensure the config file uses absolute paths to avoid runtime path issues.

Available tools

create_payment_intent

Create a payment with a guided workflow, collecting optional details and returning a payment intent ID for status checks.

get_payment_intent

Retrieve the status of a payment using its payment intent ID.

get_transaction

Fetch a single transaction by its ID.

get_transaction_by_order

Find a transaction using an order number.

list_transactions

List transactions with smart filtering and pagination.

get_portals

List your configured payment portals.

get_payment_channels

List available payment channels (up to 10 channels).

get_fpx_banks

List FPX online banking banks.