# Monapay MCP

> Monapay MCP is a freemium MCP server for finance and payments. Create VietQR codes, check bank transfers and manage webhooks for MONA Pay from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://monapay.vn
- **Repository:** https://github.com/mona-software/monapay-mcp
- **MCP Registry name:** vn.monapay/monapay-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/monapay-mcp
