Skip to content
MCP server

Monapay MCP

Create VietQR codes, check bank transfers and manage webhooks for MONA Pay from an agent

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.6.2
Listing updated
2 days ago

About Monapay MCP

Monapay MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Set-up is the hard part of bank-transfer payments in Vietnam, and this server automates much of it from a coding agent. It can link an ACB bank account (two OTP steps), create a virtual account, turn on incoming-transfer notifications, and then create hosted checkout links or dynamic VietQR codes per order.

For testing there is a sandbox tool that fakes an incoming transaction, firing webhooks and Telegram, email and Zalo notifications as for a real one. Webhooks can use no auth, an API key or HMAC-SHA256, which is recommended, with test sends, delivery logs and success statistics.

It needs a MONA Pay client_id and client_secret created in the dashboard. MONA Pay lists a free tier of 500 transactions a month with no percentage fee.

Install

Run in a terminal

claude mcp add monapay-mcp --env MONAPAY_CLIENT_ID='<MONAPAY_CLIENT_ID>' --env MONAPAY_CLIENT_SECRET='<MONAPAY_CLIENT_SECRET>' -- npx -y monapay-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "monapay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "monapay-mcp"
      ],
      "env": {
        "MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
        "MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "monapay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "monapay-mcp"
      ],
      "env": {
        "MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
        "MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "monapay-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "monapay-mcp"
      ],
      "env": {
        "MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
        "MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "monapay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "monapay-mcp"
      ],
      "env": {
        "MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
        "MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "monapay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "monapay-mcp"
      ],
      "env": {
        "MONAPAY_CLIENT_ID": "<MONAPAY_CLIENT_ID>",
        "MONAPAY_CLIENT_SECRET": "<MONAPAY_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • MONAPAY_CLIENT_IDMONA Pay API key client_id (create in dashboard my.monapay.vn).Required
  • MONAPAY_CLIENT_SECRETMONA Pay API key client_secret (shown once). Needed for write actions (create QR, webhooks).Required
  • MONAPAY_BASE_URLOptional API base URL (default production).

Tools this server provides (28)

Taken from the project documentation; the running server may differ.

monapay_quickstart
Check account state and return next steps.
monapay_whoami
Verify the connection and return account name and plan.
monapay_me
Profile of the logged-in account.
monapay_link_bank_start
Start linking an ACB account.
monapay_link_bank_verify_otp
Verify the first OTP.
monapay_notification_register
Turn on incoming-transfer notifications.
monapay_notification_verify_otp
Verify the second OTP.
monapay_list_bank_accounts
List linked bank accounts.
monapay_list_virtual_accounts
List virtual accounts.
monapay_get_payment_profile
View the checkout profile.
monapay_set_payment_profile
Set the checkout profile.
monapay_create_checkout
Create a hosted checkout session.
monapay_get_checkout
Inspect a checkout.
monapay_list_checkouts
List checkouts.
monapay_cancel_checkout
Cancel a checkout.
monapay_create_qr
Create a dynamic VietQR.
monapay_cancel_qr
Cancel a QR.
monapay_list_transactions
List incoming transactions.
monapay_get_transaction
Find one transaction.
monapay_get_transactions_summary
Totals and daily data for a range.
monapay_sandbox_transaction
Create a fake incoming transaction.
monapay_list_webhooks
List webhooks.
monapay_create_webhook
Create a webhook.
monapay_update_webhook
Update a webhook.
monapay_delete_webhook
Delete a webhook.
monapay_test_webhook
Send a dummy webhook.
monapay_webhook_logs
Per-delivery history.
monapay_webhook_stats
Success rate and P95.

What it does

Bank linking
Links an ACB account and creates a virtual account.
Checkout and VietQR
Creates checkout sessions and dynamic QR codes.
Transaction lookup
Lists and summarises incoming transfers.
Webhook management
Creates, tests and monitors signed webhooks.
Sandbox transactions
Simulates incoming payments.
Group notifications
Configures email and Zalo notifications.

Good for

  • Wire up payment confirmation for a new shop
  • Create a QR code for a specific order
  • Reconcile incoming transfers for a date range
  • Test a webhook without a real payment

Pricing

Freemium

500 transactions a month free; paid tiers not published

Prices change. Check monapay.vn before you buy.

Monapay MCP FAQ

What credentials are needed?

MONAPAY_CLIENT_ID and MONAPAY_CLIENT_SECRET from the dashboard.

Is there a free tier?

The site lists 500 free transactions a month and no percentage fee.

How are webhooks secured?

HMAC-SHA256 is recommended; the SDKs verify signatures and reject timestamps beyond 300 seconds.

What runs it?

npx -y monapay-mcp over stdio, Node.js 18 or later.

Is Monapay MCP free?

Monapay MCP has a free plan, with paid plans for more usage or features.

How do I add Monapay MCP to Claude Code?

Run this command in your terminal: claude mcp add monapay-mcp --env MONAPAY_CLIENT_ID='<MONAPAY_CLIENT_ID>' --env MONAPAY_CLIENT_SECRET='<MONAPAY_CLIENT_SECRET>' -- npx -y monapay-mcp

What are the best alternatives to Monapay MCP?

The closest alternatives to Monapay MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Monapay MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government